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PREFACE 



This manual is a reference document for DELTA, the Honeywell CP-6 universal debugger. 
DELTA is the debugger used for all programs produced by non-interpretive longuage 
processors (those that produce code which is LINKed and stored). 

This reference describes in encyclopedic fashion the language elements, commands and 
features of DELTA. It is intended for use by: 

o The experienced system programmer. 

o The application programmer who is already familiar with DELTA. It is assumed that 
this reader has read the DELTA appendix contained in the appropriate programming 
language manual (e.g., the CP-6 COBOL or FORTRAN Programmer Guide or the CP-6 RPG 
Reference Manual). 



The Los Angeles Development Center (L.A.D.C.) of Honeywell Information Systems Inc. has 
developed Computer Aided Publications (CAP). CAP is an advanced document processing 
system providing automatic table of contents, automatic indexing, format control, 
integrated text and graphics, and other features. This manual is a product of CP-6 CAP. 

Readers of this document may report errors or suggest changes through a STAR on the CP-6 
STARLOG system. Prompt response is made to any STAR against a CP-6 manual, and changes 
will be incorporated into subsequent releases and/or revisions of the manuals. 

The information in this publication is believed to be accurate in all respects. 
Honeywell Information Systems cannot assume responsibility for any consequences 
resulting from unauthorized use thereof. The information contained herein is subject to 
change. New editions of this publication may be issued to incorporate such changes. 



The information and specifications in this document are subject to change without notice. This 
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About this Manual 



The contents of this manual are grouped into the following nine sections and two 
appendi xes. 

Section 1, Introduction 

o Introduces DELTA, and the repertoire of DELTA commands. 
Section 2, Prerequisite Information 

o Defines DELTA-spec i f i c terms and describes the conventions used in the syntax of 
DELTA commands. 

Section 3 Through 8 

o Each section explains one of the six functional use categories and its commands. 
Sect i on 9 

o Explains how to debug programs running in the FEP. 
Appendix A, DELTA Distinguished Names 

o Identifies and explains the hardware or system oriented entities that have been 
assigned names which may be in the syntactical components of several of DELTA'S 
commands . 

Appendix B, Assembler Instruction Formats for Patching 

o Identifies and explains the exceptions to the, standard GMAP6 instruction format for 
1-word instructions. 
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Notation Conventions 



Notation conventions used in format specifications and examples throughout this manual 
are I i sted be I ow. 



Notation Conventions Table 



Notation Description 



Lower-case Letters 

Lower— case letters indicate that the element is a variable, to be 
replaced with the desired value. 



CAPITAL LETTERS 

Capital letters indicate a literal, to be entered as shown. 



Brackets 

An element inside brackets is optional. If elements are stacked 
vertically within brackets, the elements may be omitted or one of them 
may be entered. The brackets may be elongated to contain the stack of 
elements, or may be represented by vertically-stacked printed 
brackets. For example, the notation 

[DISK] 
[TAPE] 

means that the user may omit this entry, or may enter DISK, or may 
enter TAPE. When used to enclose keywords, brackets signify that the 
bracketed portion may be omitted, or truncated at any point. For 
example, the notation K[EY] means that the user may enter K, KE, or 
KEY. 



Braces 

Elements stacked inside a pair of braces identify a required choice. 

id | means that either a value for id or the 
ALL) word ALL must be entered. 

Alternatively, the vertical OR bar is used to separate the choices, 
thus: { i d | ALLj 
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Notation Conventions Toble (cont.) 

Notot i on Description 



Hor i zonta I El I i psi s 

The horizontal ellipsis indicates that a previous bracketed element 
may be repeated, or that elements have been omitted. 

attachment [; attachment] ... means that one or more 
attachments may be entered, with a semicolon inserted 
between each attachment. 



Numbers/Special Characters 

Numbers that are not part of a parameter name, special symbols, and 
punctuation marks other than brackets, braces and underlines appear as 
shown in output messages and must be entered as shown when input. 

\f means that a format specifier (f) must be 
preceded by a \ character. 



Notation Conventions 
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Section 1 
Introduction 



DELTA is the Universal Debugger for CP-6 programs. It is a special shared processor 
that, when invoked by a user, adds a system level dimension to the user's domain. This 
dimension includes levels of logic with a precise understanding of the programming, 
object, and machine languages. When invoked on behalf of a user, DELTA assumes both the 
user's identity and privilege levels. 

DELTA is driven by a set of English-like statements called commands. These commands may 
be presented to DELTA directly through an interactive terminal or interspersed with IBEX 
commands in a batch job stream. In either case, DELTA translates the commands into the 
language of that execution level which is capable of carrying them out. Using DELTA, 
the user may: 

o Conduct debugging sessions in the interactive or batch modes, 
o Apply permanent patches to a run unit. 

o Obtain current or post-mortem dumps of portions of a run unit. 

o Examine the executing monitor. 

o Examine any executing domain of the system. 



External Debugging 

DELTA is an external debugger. It does not increase the size of the executing run unit. 
Although it is associated with the run unit, it is completely independent of it. This 
is possible because: 



1. A standard CP— 6 language processor: 



o Outputs a compile unit containing processing instructions, data definitions and 
linkage declarations. 



o Outputs a highly encoded information map called a debug schema which defines the 
symbolic names given to all internal procedure labels, data names and external 
linkage names. The encoded schema defines the size, attributes and hierarchical 
shapes of all data names and any name scoping rules which apply either to block 
structured compile units or those which define variables in local, global or 
common sets. If the language processor permits nesting of subordinate procedure 
constructs (internal procedures), their hierarchical shapes are also encoded 
into the schema. The schema is stored along with the compile unit in a common 
file. 



2. The LINK processor: 

o Links the individual compile units into the run unit, updates the debug schema 
from each compile unit to reflect the actual assignment of addresses, and writes 
all of the debug schema into the run unit file along with the program image. 

3. The moni tor: 

o Relays to DELTA any trap or fault occurring during execution of the run unit. 
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o Relays to DELTA any exceptional condition which the run unit is not programmed 
to handle. 

4. DELTA: 

o Uses the debug schema to resolve symbolic references. 

o Acts as an interface between the user, the run unit, and the monitor. 

Languages Supported 

DELTA may be used to debug programs produced by: 

o COBOL/COBOL-E 

o FORTRAN 

o PL-6 

o RPGII 

o GMAP6 

o FPL 

o Any language processor that produces code acceptable to the CP-6 LINK processor with 
or without debug schema information. 

Program units produced by any of these language processors may be freely mixed, linked 
into a single run unit, and debugged under DELTA. 

Capabi I it ies Summary 

DELTA may be executed in three major modes of operation. These are: 

1. The Debugging Mode 

2. The ANLZ Mode 

3. The RUM (Run Unit Modification) Mode 

Debugging Mode 

DELTA allows debugging at the level of complexity that best suits the user's needs: at 
the source language level or at the machine language level. 

Debugging at the source language level is accomplished using the terms and constructs of 
the language in which a particular program unit was written. Debugging at the machine 
language level is accomplished by using assembler mnemonics and special symbols. These 
two levels are not mutually exclusive; they may be used simultaneously. During a 
debugging session, program entities can be referred to using the terminology of either 
or both levels. 

The following is a summary of the major capabi I i t i es prov i ded by the debugging mode of 
DELTA. During a debugging session the user may: 

o Refer to the elements of the run unit as named in the source program. Using these 
names, the user may display and modify these program elements before, during and 
after program execution. 

o Determine the memory addresses of symbolic procedure and data names. 
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o Trace and record the flow of control of the executing run unit at several levels: 
on all entry points, on specified entry points, on all transfer points, or on 
specific locations. A history mode may be set such that trace information is saved 
for examination at a later time. 

o Cause the flow of control to be conditionally or unconditionally altered based upon 
observation of the run unit in execution. Program execution may be interrupted at 
any time (using the break key) to allow interaction with DELTA. 

o Search both procedure and data space for the occurrence of specific bit patterns 
within words of memory. A search may optionally be conducted under control of a 
mask and selective substitution may be performed under mask. 

o Obtain snapshot or post-mortem dumps. Snapshot dumps may be taken at any time 
during a debugging session. Post-mortem dumps may be conditionally or 
unconditionally obtained by placing the proper command in the IBEX command stream 
for jobs executed in the batch mode in either the test or production environment. 
It is also possible for a run unit to associate DELTA programmat ical ly within the 
exceptional condition handling routines, and to specify activities to be carried out 
by DELTA. 



ANLZ Mode 

The ANLZ mode of DELTA may be invoked only by those users who have been granted 
sufficient privilege by the System Manager. The ANLZ mode, when invoked, extends the 
visibility of DELTA to the internals of the CP-6 monitor itself. The user may observe 
the running monitor in execution, modify its data and procedure and, in general, perform 
any DELTA function which does not slow or halt system operation. 



RUM Mode 

By invoking the RUM mode of DELTA the user may: 

o Permanently patch both the procedure and data of a run unit, primarily using the 
assembly instruction mnemonics. 

o Modify certain of the control information in the run unit's HEAD record. 

o Cause DELTA to provide a listing of all permanent patches. 

Summary of Commands 

Table 1-1 lists the entire repertoire of DELTA commands under the appropriate functional 
categories and sub— categor i es . 



Table 1-1. DELTA Commands 


Housekeepi ng 




Input/Output Control: 




COPY 




ECHO 




! EOM 




OUTPUT 




PROMPT 




READ 




REPORT 




SYNTAX 
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Toble 1-1. DELTA Commands (cont.) 



Fault and TRAP Control: 

IGNORE 
KEEP 

ON ABORT 
ON EXIT 
TRAP 

Addressing and Symbol Control: 

ALTERNATE VAR 

BYPASS 

DEFINE 

FORMAT 

RANGE 

SCHEMA 

USE 

Stored Command Management: 

ACTIVE/INACTIVE 

DO 

KILL 

SAVE 

SHOW 

SI LENT/UNSI LENT 
UPDATE 



Execut i on Cont ro I 

Procedure Breakpoint: 
AT 

ON CALL(S) 
ON NODE(S) 

Data Breakpoint: 

WHEN 

Transfer of Control: 

ALIB 
BREAK 
EXIT 
GO 

GO TRAP 
UNSHARE 
XCON 

Procedure Stepping: 

GO STEP 

GO TRAP STEP 

STEP 
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Table 1-1 . 


DELTA Commands (cont.) 


Execut ion Tracing 




HISTORY 

PLUGH 

TRACE 




Memory Display and Modification 




Variable Oriented Commands: 




DISPLAY 
LET 




Word Oriented Commands: 




DUMP 

EVALUATE 

FIND 

MODIFY 

STORE 




Post Mortem Dump: 




PMD 




Mode Control 




ANLZ 
RUM 




Mi see I I aneous 




END 

HELP 

LIST 

QUIT 
SAD 
UNFID 
XEQ 





A complete list of DELTA'S commands with acceptable minimal abbreviations can be found 
in Tables 1-2 through 1-7. 

During a debugging session, the user may exercise almost total control over the 
execution of his run unit through the AT, ON, and WHEN commands. These three commands 
which are referred to as breakpoint commands are described in Section 4. The remainder 
of the commands in DELTA'S repertoire are complements to these three commands. 

The commands issued to DELTA are acted upon at different times. Some are executed 
immediately; others ore stored for subsequent execution based upon some specific 
occurrence, and some are executed in conjunction with those which have been stored. 
DELTA commands can assume one or more of the following attributes: 
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1 . Stored 



2. Attached 

3. Immediate 

4. Toggled 



Stored Commands 

Stored commands are those which instruct DELTA to perform an action at some later time 
based upon the arrival of the Instruction Counter at a specific location or upon the 
occurrence of some specific event (the AT, ON, and WHEN commands primarily). When 
issued, these commands are assigned an identification number (id) either by the user or 
by DELTA (if the user does not), which is included in DELTA'S report each time the 
command is activated. Stored commands may have other commands attached to them which 
are to be executed whenever the stored command is activated. 
General Syntax 

A stored command and its attachments are issued in the form: 
[id] [stored command] [ ;attachment] [ attachment] ... <CR> 
The command line ends with a carriage return or end-of-record . 

Commands can be continued onto a new line if the previous line ends with a semicolon and 
the new line begins with an attachment. 

Example: 

10 AT READ-MASTER; DISPLAY NETPAY.GROSSPAY, DEDUCT IONS <RET> 
The example includes the following elements: 

1. The stored command AT READ-MASTER was assigned an id of 10 by the user. If a stored 
command with the same id already exists, it will be replaced. 

2. The single DISPLAY attachment will display three items (variables) within the user's 
run unit: NETPAY. GROSSPAY, and DEDUCTIONS. 

3. The semicolon (;) is used to separate attachments. 

In the above example, the programmer directs DELTA to set a breakpoint at the location 
"READ-MASTER" in the run unit. When the Instruction Counter reaches this location, 
DELTA will report the breakpoint at the user's terminal and then display the requested 
variables. If the programmer does not wish to interact with DELTA following the 
display, the command should be written: 

10 AT READ-MASTER; DISPLAY NETPAY .GROSSPAY, DEDUCT IONS; GO 

With the command written in this form, DELTA will not stop after performing the display 
but will cause the run unit to resume execution as though the breakpoint had not 
occurred. 
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Conditional Execution 

Format : 



IF var logical_operator cons 



Parameters: 



var is any position or location reference. Position and location references are 
described in Section 2. 



logical_operator 



is any of the following: 



EQ 



equa I 

not equal 

less than 

greater than 

less than or equal 

greater than or equal 



X O NE 
< LT 
> GT 
<= =< LE 
>= => GE 



cons 



is any literal: octal, decimal, bit or character. 



Description: 

All stored commands may be formed to specify varying levels of conditional execution by 
using IF conditional. The IF conditional must be used as part of another command. 

The value described by var is compared with the constant value. If the logical relation 
is true, then the stored command is reported and its attachments executed (if the 
condition was on a stored command), or the attachment is executed (if the condition was 
on an attachment). 

Spec i f i cat i on of an IF condition is allowed on almost all DELTA commands. Specific 
instances where the IF is not allowed are noted in the description of the commands. 

Taking into account the IF condition, the complete specification of stored commands is: 

[id] stored_command [IF var I og i ca l_ope rator cons] 

[;attachment [IF var logical_operator cons] 



1. The operators =, >=, <=, etc., cannot be entered from an online terminal unless 
"KILL EOM" has been specified. 



20 AT ROUTINE 10 IF NET.PAY EQ 0; DISPLAY DEDUCTIONS; 
DUMP PAY_RECORD,20; GO 

In this example, IF specifies conditional execution. When the ROUTINE10 breakpoint is 

reached, NETPAY will be examined to determine if its value is zero. If its value is not 

zero, DELTA will not report to the user that ROUTINE10 has been reached nor will any of 
the attachments be executed. 
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[jattachment [IF var log?cal_operator cons]] ... ] 



Ru I es: 



Example: 



Attached Commands 



Most DELTA commands may be issued as attachments to any stored commands. The exceptions 
are STEP, XEQ, and all stored commands. 



Immediate Commands 

A command (other than a stored command) assumes the immediate attribute whenever it is 
issued in-line. In the interactive mode this occurs whenever DELTA has issued its 
prompt character. In the batch mode this occurs whenever DELTA reads a command. 

Example: 

>D I SPLAY NET_PAY 

In this context, DISPLAY is being used in an immediate way. 



Toggle Commands 

Certain of the commands in the housekeeping category set toggles within DELTA. These 
toggles may be reset by the KILL command. Those commands which set toggles are 
identified in Table 1-2 which is a functional summary of housekeeping commands. Tables 
1-3 through 1-7 are functional summaries of the remaining five categories of DELTA 
commands. In these tables the brackets [] are used to indicate the minimum 
abbreviations allowed for each command. 



Table 1-2. Housekeeping Commands 


Command 


Funct i on 


AC[TIVE] | IN[ACTIVE] 




Activates or deactivates a single or a range of stored commands. 


ALTERNATE] VARIABLES] 




Specifies alternate debug schema to be searched when an unqualified 
variable reference is not satisfied by searching the current schema. 


BY [PASS] 


Bypasses assembler program units during stepping. This command sets a 
toggle within DELTA. 


C[OPY] 


Causes DELTA output to be copied on the user terminal when the 
specified destination for output is other than the user terminal. This 
command sets a toggle within DELTA. 
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Table 1-2. Housekeeping Commands (cont.) 


Command 


V 

Funct ion 


DE[FINE] 


Associates a value or location with a symbol. | 


DO 


Executes the attachments to a stored command or a group of commands 
identified by the SAVE command. 


EC [HO] 


Causes input to be echoed to an output device when DELTA input is from 

u ucv i u uio i i nun uii sj 1 1 line iciiitinui* i n i 9 \* uiiwiu 11 u solo u iuyy 1 c 

within DELTA. 


EO[M] 


Set or reset special activation (end of message) character set. This 
command sets a toggle within DELTA. 


FO[RMAT] 


Specifies default format for MODIFY and EVALUATE display output. 


KE[EP] | TRAP | IG[NORE] 




Direct DELTA'S handling of asynchronous events and other exceptional 
condi t ions. 


K[ILL] 


Deactivates a toggle or removes a stored command or a range of stored 
commands . 


0[N] A[BORT] 


Specifies activities to occur upon abort. 


0[N] E[XIT] 


Specifies activities to occur upon normal exit. 
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Table 1-2. Housekeeping Commands (con t.) 


Command 


Funct i on 




nuTTPi itI 


Specify destination for DELTA output. 




PRO[MPT] 


Sets the DELTA prompt character (default is >) . 




RA[NGE] 








Specify range of offsets from defined symbol to be used 
reporting. 


for position 


R[EAD] 


Causes DELTA to read other than the normal input stream. 




REP[ORT] 


Directs DELTA'S formatting of position reporting. 




SA[VE] 








Stores and remembers a single or a range of stored commands. 


SC[HEMA] 








Activates or deactivates schema usage or sets "current" 
command sets a toggle within DELTA. 


schema. This 


SH[OW] 








Displays the status of toggled options, keyword options 
range of stored commands and attachments. 


or a single or 


SI [LENT] |UN[SILENT] 






Activates or deactivates the reporting of a single or a 
stored commands. 


range of 


SYfNTAX] 








Allows specification of FORTRAN, COBOL, or PL-6 input syntax. 
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Table 1-2. Housekeeping Commands (cont.) 


Command 


Funct ion 


UP[DATEJ 






Updates stored commands or attachments of stored commands. 


U[SE] N[ODE] 






Activates schema(s) associated with a specific overlay node. 



Table 1-3. Execution Control Commands 


Command 


Funct i on 


ALI [B] 


Specifies return/a 1 1 return from M$ALIB call to DELTA. 


A[T] 


Sets an instruction breakpoint. 


B[REAK] 


Passes control to user interrupt routine. 


EX[IT] 


Exits from a run unit invoked by M$LINK and returns to the linking 
program, or continues an M$LDTRC or M$SAVE. 


G[0] 


Proceeds with program execution. 


G[0] S[TEP] 


Goes to a specified location and executes one step. 
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Table 1-3. Execution Control Commands (cont.) 


Command 


Func t i on 




G[0] T[RAP] 








Passes control to user's event handling routine when 
entered for an exceptional or asynchronous event. 


DELTA has been 


G[0] T[RAP] ST[EP] 






Same as GOTRAP except that one step is executed. 




0[N] C[ALL] 


Sets breakpoints on a specific procedure call. 




0[N] [X] C[ALLS] 






Sets breakpoints on all procedure calls. If X is specified, sets 
breakpoints only on external procedure calls. 


0[N] N[ODE] 


Sets a breakpoint on a specific overlay. 




0[N] N[ODES] 


Sets breakpoints on all overlays. 




S[TEP] 


Steps by statement or instruction. 




UNSH[ARE] 








Unshares an autoshared program and/or library so the 
execut ion cont rol . 


user can have 


W[HEN] 


Sets a data breakpoint. 




XC[ON] 








Passes control to the user's exit control procedure 
condi t ion. 


simulating an exit 
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Table 1-4. Execution Tracing Commands 


Command 


Funct ion 




H[ISTORY] 


Displays contents of history buffer (filled by TRACE). 




PL[UGH] 








(Acronym for "Procedure List Used to Get Here"). Traces back 
the automatic stack and lists the return addresses leading to 
arrival at the current procedure point. 


th rough 
the 


T[RACE] T[RANSFERS] 






Traces all transfer instructions. 




T[RACE] [X] C[ALLS] 






Traces entry to all procedures. If X is specified, trace entry to 
external procedures only. 



Table 1-5. Memory Display and Modification Commands 


Command 


Funct i on 


DpSPLAY] 


Displays the value of a variable or the contents of an address. 


DU[MP] 


Dumps a specified range of memory in octal or hexadecimal format. 
Optionally allows no suppression of duplicate lines. Optionally 
provides ASCII translation. 


E[VALUATE] 


Evaluates an expression and reports its value in a specified format. 
Reports the address of a program entity by segment and offset. 
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Table 1-5. Memory Display and Modification Commands (cont.) 


Command 


Funct i on 


F[ IND] 


Searches memory under mask and optionally substitutes under mask. 


L[ET] 


Changes the value of a variable or the contents of an address. 


M[ODIFY] 


Displays the contents of an address and optionally replaces it with 
new contents. 


PMD 


L/unips spec i i i cq pun i ons ui a proyrum wn i cn icrmi notes aunorrnuiiy. 


STO[RE] 


Modifies a range of memory. Optionally performs the modification 
under mask. 



Table 1-6. Mode Control Commands 


Command 


Function 


AN[LZ] 


Associates the schemas for the CP-6 Monitor, or associates the schema 
from the specified file, and sets DELTA'S domain of reference to that 
of the running monitor, a specified system dump file, or the running 
program. 


RU[M] 


Invokes the Run Unit Modification mode, optionally specifying the 
number of buffers to use for faster I/O (up to 10, default is 5). 



1-14 



Toggle Commands 



CE39-03 



Table 1-7. Miscellaneous Commands 


Command 


Funct ion 


EN[D] or 


Q[UIT] 

Unconditionally exits to the command processor. 


HELP 


Provides HELP via the HELP facility. 


LI[ST] 


Lists changes made during Run Unit Modification. 


PROT[ECT] 


Sets Protect mode (disallows LET, MODIFY store). 


SAD 


Special Access Descriptor allows addressing through a Monitor 
descriptor for privi leged users. 


UNF[ID] 


Performs M$UNFID on specified DCB. 


X[EQ] 


Executes a GMAP6 assembler instruction. 



Invoking DELTA 

DELTA can be invoked by entry of any of the following commands: 

I S[TART] fid U[NDER] DELTA 

to start a program with DELTA associated. 

! I DELTA 

to associate DELTA with a running program at any time, or after 
a program aborts. 

! DELTA 

to use DELTA in calculator mode (i.e., no program associated). 

!PMD 

to perform post-mortem dumps. 
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as explained in the following subsection. 



DELTA may be entered at three times during the life of a program: as it starts 
execution, during execution and after a program aborts. DELTA may also be called in 
stand-alone mode, and at run-time by a user program via the M$ALIB monitor service. The 
methods of invocation and uses are discussed below. 



Initiating A Program with DELTA Associated 

Most debugging sessions ore begun by starting the program to be debugged under DELTA. 
This is accomplished in two ways, both are commands in IBEX. 

!S[TART] fid U[NDER] [DELTA] 

This command brings a run unit named fid into memory and prepares it for execution. 
DELTA is entered with the user program ready to run. DELTA prints the current value of 
the instruction counter, the program start address. For example: 

! START COBOLRU UNDER DELTA 

DELTA B03 HERE IC = PROG:0 [ENTRY] 

This method can be used online and in batch. The user may now use any of the DELTA 
commands, or just say GO to begin execution. IC is the instruction counter and 
indicates the address that is about to be executed. 

If the user's program reads the invocation line from B$JIT.CCBUF or depends on IBEX to 
implicitly set DCBs, the start command should not be used. Instead the IBEX command U 
may be used. The U implies the words UNDER DELTA on the next command line. For 
example: 

!U 

IMYCOMP.ME ON OUFILE.LP (LS.OU) 
DELTA B03 HERE IC = MAIN:0 [ENTRY] 

In this case, the invocation line that is placed in B$JIT.CCBUF will be the same as if 
DELTA were not associated. 



Post Association of DELTA 

DELTA may be associated with a running program at any time. This is useful when a 
program appears to be looping or is in a bad or unexpected state, and the user wants to 
interrupt execution and see what the IC value is, or look at program variables. To 
associate DELTA after the program has started, the user types CTRL Y. IBEX prompts with 
a double bang (!!). The user types DELTA to associate DELTA with the interrupted 
program. When DELTA is associated, if the program is autoshared, the user should use 
the UNSHARE command if any modification of procedure (including breakpoints) is to be 
done. For example: 

I MYPROG . 

The program does not prompt as expected; a loop is suspected. The user enters 
<CTRLXY>. 

! ! DELTA 

DELTA B03 HERE IC = INITVALS:54, , .3 [ASSIGNMENT] 
This method is only available online. 

When a user program aborts, IBEX holds the image of the run unit in memory. The user 
can associate DELTA with the image by typing DELTA immediately after the abort message. 
For example: 
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! MYPROG . 

memory fault (IBEX reports program abort due to 

memory fault) 

! DELTA 

DELTA B03 HERE IC - SUBPR06 : 73 , , . 5 [INPUT/OUTPUT] 

DELTA reports the IC value at the time of the fault. Any DELTA command can be issued, 
and the program can be continued by the GO command. 



No Run Unit Associated 

DELTA can be entered alone, i.e., with no program associated. This is sometimes 
referred to as calculator mode. DELTA is usually used to evaluate expressions when 
entered in stand-alone mode, although small programs in GMAP6 instruction format may be 
entered. For example: 

"DELTA 

>DELTA B03 HERE - NO RU ASSOCIATED 

>EV 250 +.13\U 

= 261 

>.101\C 

= 'A 

>M .30 LDQ 43. DL 
>M .31 0 
>GO .30 

IPR fault O .31/0 
>D $Q\U 
$0=43 

The procedure space available to the user when DELTA is in the stand-alone mode extends 
from location .20 to location .2000; locations .0 to .17 are reserved for use by DELTA. 
KILL EOM is the default in stand-alone mode. To enable it, the user can use the EOM 
command . 



Programmed Association of DELTA 

DELTA may also be associated by a running program via the M$ALIB monitor service call. 
Using this service a command may be passed to DELTA for execution. This is useful to an 
exceptional condition handling routine in a production program. If, for example, the 
program has entered the XCON routine due to bad data in an input buffer, a DUMP command 
may be passed to DELTA to print the offending buffer. 



Communications with DELTA 

DELTA uses the prompt character *>' when it is waiting for the user to enter a command 
at the terminal. All commands should be ended with the <RETURN> key on the keyboard. 

All commands, except for the open form of the MODIFY command, will error if ended with 
<LINEFEED>. When <LINEFEED> is used with the open form of the MODIFY command, the next 
memory cell will be opened for modification. 

By default, DELTA uses a special End-of-Message (EOM) character set. These are 
characters which terminate the mode and activate DELTA. The complete list of DELTA EOM 
characters includes T, <LINEFEED>, <TAB>, <RETURN>, [, {, ], \, /, and =. Most of the 
special EOM characters are used only when debugging at the assembly or machine language 
level. However, ] and \, which have the same effect, are a shorthand for the STEP 
command and are very convenient for stepping through a program. In order to enter any 
of these characters without activation to DELTA, for instance in a character string 
constant for the LET command, DELTA'S special activation set must be turned off. This 
is done with KILL EOM command. The EOM command turns the special activation set back 
on. KILL EOM is the default for stand-alone mode. 
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If a symbol name is used that matches one of DELTA'S special names, contains a period 
and is not a PL— 6 structure name, contains a colon, or begins with an *, the symbol name 
must be specified by enclosing it in quotes followed by an "S" . For example: 

•$JIT'S 
' .LABEL'S 

If DELTA is already associated, depressing the break key will cause the running program 
to be interrupted. DELTA will report the current IC position and prompt for input. 
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Section 2 

Prerequisite Information 



Symbol ic Address ing 

A data name, statement label, statement number or any symbolic name assigned by using 
the DEFINE command during a debugging session may be used as a symbolic memory 
reference. When a symbolic memory reference is made, DELTA determines the actual memory 
addresses associated with the symbol. The rules governing the formation of symbolic 
names differ among the various programming languages. The symbolic name "X" could be an 
external procedure name in PL-6, a file name in COBOL or an element of an array in 
FORTRAN. For this reason, language processors place symbols which refer to data 
addresses (data names) and those which refer to procedure addresses (statement labels, 
statement numbers) in different tables within the schema. DELTA must therefore 
determine which of these tables is to be searched when resolving a symbolic reference 
into a memory address. 



Resolving A Symbolic Reference 

There are two classes of symbolic references: 

1. A LOCATION REFERENCE refers to a memory address which contains data. 

2. A POSITION REFERENCE refers to a memory address that contains an executable 
i nst ruct i on . 

DELTA does not require any special user effort to distinguish these references. In some 
cases, however, it is necessary to override DELTA'S assumptions about a particular 
symbolic reference. This is explained in the commentary on those commands where it 
appl ies. 



Symbolic Location Names 

The following paragraphs will name and describe data entities as they are known to 
DELTA. These names will be used throughout the remainder of this manual. 



S c a L a r s 

A scalar is a single item of data, an element. 



Structures 

A structure is a hierarchical set of names that refers to an aggregate of data items 
that may have different attributes. The various members of the structure may be further 
identified through the assignment of member names. There are two kinds of structures: 
major and subordinate. 

A major structure exists at the highest level of the data hierarchy. It is known as a 
Level 1 structure to DELTA and is not viewed as being dependent or related to any other 
data construct. 
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A subordinate structure exists at some lower level of the data hierarchy (meaning 
level number greater than 1) and is always contained within some structure with a 
number less than its own. 



E Lemen t ary I tern 

An elementary item exists at the lowest level of the data hierarchy. 



Array 

v 

An array is a contiguous, named series of data constructs all of which have identical 
sizes and characteristics. Because each data construct has the same name, they must be 
referred to by their position within the array for unique reference. DELTA recognizes 
all forms of arrays exactly as they are declared by each of the CP-6 language 
processors. The rules that govern subscripting and/or indexing in the language through 
which the array was declared are recognized and honored by DELTA in any symbolic 
location reference. 



Pointer 

A pointer is a location reference construct used to specify a particular address in 
memory. There are several kinds of pointers. They will be discussed in later 
paragraphs in the context to which they apply. 



Variable 

A variable is the name used in any general reference to all of the data entities named 
above. Wherever a distinction in their treatment by DELTA is important, they will be 
referred to by their proper names. 



Symbolic Position Names 

The following paragraphs name and describe procedure entities whose names may be used in 
symbolic position references. They also identify those whose names may be used to 
qualify both position and location references. 



Node 

A node is an element in an overlay structure. A node name is the highest level 
qualifier that can be used in an address reference. Node applies only to overlaid 
programs. 

External Compile Unit 

An external compile unit (ECU) is the unit of compilation or assembly — the input to 
the LINK processor. An ECU name may be used to qualify both position and location 
references. Note that the ECU name is that name defined within the procedure code and 
not the name given to the object unit file in which it is stored. 



some 
I eve I 
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Internal Program Unit 



An internal program unit (IPU) is a logical block within an external compile unit which 
limits the scope of both procedure names and data names. An IPU name may be used to 
qualify both position and location references. 



Entry Name 

An entry name is an externally known procedure location within an external compile unit. 
There are primary entry names and secondary entry names. A primary entry name is one 
which names an external compile unit. Both may be used to qualify position and location 
references. 



Statement Label 

A statement label names a position within an ECU or IPU that may be used as the target 
of a transfer of program flow. 



Statement Number 

A statement number is that number assigned by a language processor to each statement 
that it translates into object code. DELTA recognizes statement numbers as valid, 
symbolic position references. 



Subs ta tement 

A substatement is a division of a statement. 



Offset 

An offset is the octal or word offset from the specified statement/substatement . When a 
substatement is not specified, an offset must be preceded by two commas. 



Format For Pos i t i on 

Position is used in the AT, GO, and G0STEP commands and sometimes in the MODIFY command. 
The format for position can be one of the following: 

o [ECU] : statement number , substatement .off set 

For the AT, GO, and G0STEP commands, if ECU is omitted, the colon is optional. For 
the MODIFY command, the colon is required. The offset may be specified in octal or 
decimal. For example, 

: 1 0 . 1 . .1 

o ECU J : INTERNAL ENTRY, ... \ : label , substatement, offset. 

Label must be fully qualified by all INTERNAL ENTRIES necessary. 
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Example: 

PROGNAME : PROCA : PROCB : LABEL1 
o ECU + offset 

PROGX+.54 
o octal address 

The octal address must be preceded by a period to be octal. 

. 2004 
Note: 

1. 2004 will be interpreted as: 

a. statement 2004 if used with an AT, GO, or GOSTEP command 

b. decimal location 2004 (octal location .3724) if used with any other command. 

Symbolic Address Qualification 

The following six levels of qualification may be required by DELTA to accurately resolve 
a memory reference: 

1. Domain (XDELTA only) 

2. Node name (overlaid program only) 

3. External compile unit name (ECUNAME) 

4. Internal program unit name (IPUNAME) 

5. Major structure name (MS) 

6. Subordinate structure name (SS) 

Most qualification levels are summarized in Table 2-1. 



Table 2-1. Summary of Symbolic Qualification 



Qua lifer | 


How specified 


Example 


| Default to: 


NODE NAME | 


Use Command 


USE NODE ABLE 


| Current Node 


ECU | 


Name of ECU 


ECUNAME: 


| Current ECU 


IPU | 


Name of IPU 


IPUNAME: 


| Current IPU 


MS »*| 


Name of MS 


MSNAME. 


| No Defaul t 


SS | 


Name of SS 


MSNAME . SSNAME 


| No Defaul t 



* For convenience DELTA recognizes what are termed the current node, current 

external compile unit, and current internal program unit. They are determined by 
the contents of the Instruction Counter at the time that the symbolic reference is 
resolved. Note that position references are implied by a colon (:). 
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Toble 2-1. Summary of Symbolic Qualification (cont.) 



** DELTA requires that all symbolic references to structures of a data hierarchy be 
qualified with the name of each structure to which it is subordinate (e.g., to 
qualify to the level of an elementary item within a three-level structure: 
MSNAME.SSNAME. VARIABLE) . 

Note that multiple levels of structure qualification are both allowed and required 
to whatever level the elementary item is embedded: 

MSNAME . SSNAME . SSNAME . SSNAME . VAR I ABLE 

LEVELS -> 1 2 3 4 5 



Pointer Qualified References 

A pointer qualified reference has the form: 
pointer -> variable 

where pointer is a memory word which contains the address (in pointer format) of an 
ent i ty in memory. 

variable is a based structure, array or scalar (based variable). 

If the based variable was declared with an implicit pointer, DELTA is aware of the 
relationship between the pointer and the based variable and will automatically use the 
implied pointer in resolving memory references. The implied association may be 
overridden, however, by explicit pointer specification. 

Assume that ARRAY1 is an array of one dimension. It is a based variable with an implied 
pointer called ARRAYPTR. Then: 

Command Explanation 

DISPLAY ARRAY 1 (3) Display the third element of the array 

using ARRAYPTR to determine the address 
of the array (implicit qualification). 

DISPLAY ARRAYPTR->ARRAY1 (3) Same. Qual if icat ion was unnecessary. 

DISPLAY BASEPTR->ARRAY1 (3) Display the third element of the array. 

Use "BASEPTR" to determine the address 
of the array (explicit qualification). 

Multiple pointers may be used in a pointer qualified reference. 

Example: 

DISPLAY BAS EPTR 1 ->BAS EPTR2->ARR AYPTR->ARRAY (3) 
In this example: 

1. BASEPTR 1 contains the address of BASEPTR2. 

2. BASEPTR2 contains the address of ARRAYPTR. 

3. ARRAYPTR contains the address of ARRAY. 
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Notes : 

1. Every pointer in a pointer qualified reference must be in pointer format. 

Descriptor Qualified References 

All descriptors which are visible to a run unit may also be used to qualify memory 
references. Each of these descriptors is known to DELTA by a distinguished name and may 
be used as a pointer in much the same manner as a pointer variable or constant. All of 
the distinguished names known to DELTA are detailed in Appendix A. The more common ones 
are I i sted be I ow. 



Dt st i ngu i shed 
Descr i ptor 
Name 

$LS0 or $ISR 
$LS1 or $JIT 
$LS3 

$LS4 or $DS1 
$LS5 or $DS2 
$LS6 or $DS3 
$LS7 or $DS4 
$LS8 or $DS5 
$LS9 or $DS6 
$LS10 or $DS7 
$LS11 or $DS8 
$LS12 



Refers To: 
Instruction Segment 
Job Information Table (JIT) 
Read Only Segment 
Automatic Segment 
Common Segment 
Dynamic Data Segment 3 
Dynamic Data Segment 4 
Dynamic Data Segment 5 
Dynamic Data Segment 6 
Dynamic Data Segment 7 
Dynamic Data Segment 8 
Nu I I Segment 



Whenever descriptor qualification is used, the distinguished name of the descriptor must 
be the leftmost qualifier in the memory reference. 



Example: 
Command 

DISPLAY $LS5->ARRAY1 (3) 
DISPLAY $LS5->4->ARRAY1 (3) 



Meaning 

Display the third element 
of ARRAY 1 . The base address 
of the common segment is also 
the base address of ARRAY 1 . 

Display the third element of 
ARRAY 1 . Use word 4 in the 
common segment to determine 
the address of ARRAY 1 . 
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DISPLAY $LS2->e->NEXT->MS.SS.ITEM Use word zero of the segment 

described by Linkage Segment 
Descriptor #2 to determine the 
address of the based pointer 
cal led NEXT. Use NEXT to 
determine the address of the 
Major Structure called MS. 
Display the elementary item 
called ITEM contained within 
the Subordinate Structure SS. 
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Section 3 

Housekeeping Commands 



The commands discussed under this heading ore those which influence the behavior of the 
DELTA processor itself. Their purpose is to provide the greatest possible flexibility 
in specifying the manner in which to communicate with DELTA, how DELTA is to communicate 
with the user, how DELTA is to interact with a run unit and how DELTA is to deal with 
both predictable and unpredictable events which occur during the execution of a run 
un i t . 

All of the commands in this category affect the way in which DELTA behaves. Some set 
toggle switches which DELTA examines to determine whether or not a given activity is 
enabled or disabled. Others override certain default assumptions which are 
automatically established when DELTA is invoked. The default toggle settings and the 
default assumptions are those which are normally specified by the user. It is therefore 
quite probable that a debugging session can be conducted without using any of the 
commands in this section. 

Housekeeping commands are divided into the following categories: 

o Input/Output control commands 

o Addressing and symbol control commands 

o Stored command management commands 

o Fault and trap control commands 

o Miscellaneous housekeeping commands 



Input/Output Control Commands 

The Input/Output control commands include the following: 

ECHO, PROMPT , READ, OUTPUT, COPY. EOM, SYNTAX 

Input/output control commands allow the user to specify alternatives to the default 
assumptions for the following questions: 

1. From where are DELTA'S commands to be READ? 

2. Where are DELTA'S diagnostics, messages and displays to be written? 

3. Should commands read from other than the primary input stream be "echoed" on the 
output stream? 

4. In an interactive session, if the output stream has been directed away from the 
interactive terminal should DELTA'S output also be written to the terminal? 

5. What prompt character do you wish DELTA to use? 

6. How are symbols, expressions, and structure references specified to DELTA? 
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ECHO Command 



Format : 
EC[HO] 

Description: 

The user may specify that DELTA is to read its commands from some source other than the 
default stream (see the READ command). The ECHO command allows the user to see these 
commands at the interactive terminal. When ECHO is in effect, all input read by DELTA 
from other than the interactive terminal is written to the M$DO DCB. 

Usage Notes: 

1. ECHO is a toggle command. It is reset by the command: 

KILL ECHO 

2. ECHO is the initial default. 



PROMPT Command 

Format : 

PRO[MPT] char_string 
Parameters: 

chor_string is the desired prompt character string, from 1 to 28 characters. If all 
numeric characters or any non-alphanumeric are used, the entire string must be enclosed 
in quotes. 

Descr i pt ion: 

This command allows the user to change DELTA'S prompt character (>) to another character 
or string of characters. 



READ Command 
Format : 

R[EAD] [fid[.rec]] 
Parameters: 

fid may be any valid CP-6 file identifier (fid). See the discussion on fids in the 
Programmer Reference Manual (CE40) . Specifying the fid ME resets the input to the 
default command stream. When fid is a CP-6 managed file, the specification of a 
starting record number is allowed. 

rec can be either a record sequence number or, if the file is an EDIT compatible, 
keyed file, an EDIT line number. Specification of an EDIT line number must always 
contain a decimal point with the exception of record number zero (0) which is assumed to 
be edit line number 0.000. 
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Descript ion: 



Unless directed otherwise, DELTA reads from the normal program command stream. This is 
the interactive terminal during on-line sessions, the input job command stream when in 
batch, or the file of command input specified by the IBEX XEQ command in either 
situation. The DCB used by DELTA for reading its input is M$DELTA, one of the reserved 
system DCBs. A user program cannot affect this DCB; however, a user can direct DELTA'S 
input stream prior to entry to DELTA through the IBEX SET command. Once DELTA is in 
control, DELTA'S input stream may be re-directed by use of the READ command. 



Example: 

Directive Explanation 

READ MYFI LENAME Read from the file MYFI LENAME starting with 

the first record. 



READ DP#JRC/JEFFILE,5 Read from the file JEFFILE contained on 

#JRC beginning with the fifth record. 

READ EFILE.6. Read from the EDIT compatible file EFILE 

beginning with line number 6.000. 

READ ME Read from the default command input stream. 



Usage Notes: 



1. Upon reaching end-of-file or upon the occurrence of any unusual condition while 
reading, DELTA resets its input to the default command stream. 

2. Operationally, the READ command acts as a SET command on DELTA'S input DCB. It does 
not cause the ini t iot ion of any read operations; it simply alters the source of 
input for the next time that DELTA reads a command. 

3. When an EDIT key is specified but is found not to exist, DELTA begins reading at the 
f o I I owi ng record. 

4. If fid is not specified, DELTA defaults to READ UC. 



OUTPUT Command 



Format : 

0U[TPUT] [[ON | TO | OVER | INTO] fid] 
Parameters: 

[ON | TO | OVER | INTO] determines the disposition of an existing file of the same name as 
the fid. 

fid is a valid file identifier. 
Descript ion: 

DELTA'S output is always written through the M$D0 DCB. The default destination differs 
depending upon whether the session is conducted on-line or off-line. The default 
destination for an on-line session is the user's terminal; for a batch session it is the 
line printer at the user's workstation of origin. The OUTPUT command overrides these 
defaul ts. 
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Example: 



Command 



Explanation 



OUTPUT ON MYFILENAME 



Write DELTA output on a new file 
cal led MYFILENAME. 



OUTPUT OVER MYFILENAME 



Overwrite the old file called MYFILENAME with 
DELTA output. 



OUTPUT INTO MYFILENAME 



Extend the old file called MYFILENAME 
with DELTA output. 



Usage Notes: 

1. The ON or TO option will cause an error if the fid references o file which already 
exists. The OVER option will cause the file to be overwritten if the fid references 
a file which already exists. The INTO option will cause the file to be extended if 
the fid references a file which already exists. In all cases, if the fid references 
a file and the file does not exist, it will be created. If none of ON/TO/OVER/ INTO 
are specified, the default is ON. 

2. DELTA does not exercise complete control over the M$DO DCB. The connection of the 
DCB may be changed by: 

o Using the IBEX SET command. 

o Using the M$OPEN or M$CLOSE monitor service in the program 



3. If the run unit being debugged also routes data through the M$DO DCB, DELTA'S output 
will be intermingled with it. Should the run unit CLOSE the DCB, it will be 
implicitly reopened by the next write from DELTA using whatever parameters that 
rema i n . 

4. If the run unit being debugged explicity OPENs the M$DO DCB, it must be able to 
handle the ALTRET condition "DCB is already open", since DELTA will have opened the 
M$DO DCB to write its greeting message when DELTA is first associated. 



C[OPY] 

Descript ion: 

DELTA'S output is normally routed to the interactive terminal during an on-line session. 
The interactive user who has routed DELTA output to some other destination (e.g., a fid 
so that a copy of the session is maintained) may also wish to use the COPY command to 
see DELTA'S output at the interactive terminal. By using COPY in conjunction with 
OUTPUT, the user directs DELTA'S output to two places. 



being debugged. 



COPY Command 



Format : 



Examp I e : 



These examples of input/output control commands assume an on-line session. 



Command 



Explanat ion 



OUTPUT ON LP 



Direct DELTA'S output to the line printer. 



ECHO 



Write any input not received from the 
default command stream to the M$DO DCB (in 
this example, to the line printer). 
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READ MYFILE Read the next commands from the file 

called MYFILE. (Commands will be 
echoed on the line printer). 

COPY Direct DELTA'S output to two places. 

READ MYOTHERFILE Read the next commands from the file 

called MYOTHERFILE. (These commands 
will now be written both to the line 
printer and the interactive terminal). 

Usage Notes: 

1. COPY is a toggle command. It is reset by the command: 

KILL COPY 

2. KILL COPY is the initial default. 

EOM Command 

Format: 
EO[M] 

Descript ion: 

The EOM (end of message) command activates a special character set which signals end of 
message when using the MODIFY command and during program stepping. The EOM character 
set is shown in Table 6-1 which also shows sub— commands which may be used in place of 
the EOM characters. 

Cross Reference: 

See also the STEP and EVALUATE commands. 
Usage Notes: 

The EOM character set may be disabled with the KILL EOM command. The default is EOM 
unless you are in stand-alone mode. 

SYNTAX Command 

Format: 

SY[NTAX] [compiler] 
Parameters: 

compiler is one of the following: 

FfORTRAN] 
FP[L] 



PL1 



OBOL] 
L61 
PGJ 
MAP] 
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Descript ion: 

The SYNTAX command tells DELTA how symbols, expressions, and structure references are 
spec i f i ed. 

The initial default of SYNTAX is the compiler that produced the main program of the run 
unit being debugged. If compiler is omitted, the initial default compiler will be used. 
As far as DELTA is concerned PL6, RPG, GMAP6 and PL1 are identical and COBOL and FPL are 
identical; thus, three types of distinct SYNTAX can actually be specified: SYNTAX PL6, 
SYNTAX COBOL, and SYNTAX FORTRAN. 

The character set for symbols in each SYNTAX specification is identical to the character 
set allowed in the language definition. The major difference between SYNTAX COBOL and 
SYNTAX PL6 is that the embedded dash or minus sign (-) is allowed in SYNTAX COBOL. This 
difference gives rise to the difference in expressions in SYNTAX COBOL and SYNTAX PL6. 
In SYNTAX PL6, the expression operators (-, + ,*,%,»,«) must separate the expression 
elements (symbols, constants, etc.) with no separating blanks. Conversely, in SYNTAX 
COBOL the expression operations must be separated from the expression elements by 
leading and trailing blanks. 

In SYNTAX PL6, structure items are separated by periods, in order of major level 
identifier followed by minor level identifiers. A SYNTAX PL6 structure reference must 
be fully qua I i f ied. 

In SYNTAX COBOL, structure items are separated by the keywords IN or OF. The major 
level structure item is specified last, as is natural in the COBOL language. A COBOL 
structure reference may take one of three forms. In the first type of reference, only 
one identifier is specified. The reference will be satisfied by the first variable name 
that matches the given identifier, regardless of actual structure level. In the second 
type of reference, two identifiers are specified. The major structure name must be the 
second identifier specified. In the third type of reference, any number of identifiers 
may be specified. The reference must be fully qualified by specifying all low level 
references and the major structure name must be the last identifier specified. 

The SYNTAX command also tells DELTA how to interpret decimal constants for the LET 
command. For SYNTAX PL6, .octal-digit-string is considered to be a right justified 
octal constant. For SYNTAX FORTRAN, .decimal-digit-string is considered to be a 
floating point (real) constant. For SYNTAX COBOL, .decimal-digit-string is considered 
to be a fixed point decimal constant. (See the LET command for more information about 
constants. ) 

Example: 

SYNTAX COBOL 
DISPLAY D IN A 
SYNTAX PL6 
DISPLAY A.B.C.D 
SYNTAX FORTRAN 
LET REAL 3E21 

Usage Notes: 

1. When SYNTAX COBOL is in effect, it is possible to specify a non-fully qualified 
reference that DELTA considers valid, but that the COBOL compiler will consider 
ambiguous. The ambiguous reference which DELTA finds is undefined. 

2. The SYNTAX command is likely to be useful only when a run unit consists of object 
units produced by different compilers. 

3. The SYNTAX option of the SHOW command displays the current setting of the SYNTAX 
mode . 
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Addressing and Symbol Control Commands 



The addressing and symbol control commands include the following: 

SCHEMA. USE NODE. ALTERNATE VARIABLES. FORMAT, DEFINE, RANGE. REPORT. 

The commands in this category allow the user to address every area of memory in a user 
domain accessible to a run unit. Certain of the commands exist as debugging 
conveniences designed to make the task of communicating with DELTA as easy as possible. 
The DEFINE command for example, assigns symbolic names to areas of memory which were not 
symbolically defined during the compilation or assembly process. It relieves the user 
of the responsibility of having to remember memory addresses which may become important 
during a debugging session. 

The SCHEMA and ALTERNATE VARIABLE commands are used to influence DELTA'S default 
assumptions concerning unqualified, symbolic references within run units that contain 
more than one external compile unit (ECU). 

The USE command has two purposes: 

1. To specify to DELTA which node of an overlay program is to be assumed as the 
starting point for future symbolic references. 

2. To specify to XDELTA the domain of reference to be used. 

The REPORT command specifies the way that position references are reported by DELTA. 



SCHEMA Command 

Format : 

SC[HEMA] [position|f id] 
Parameters : 

position may be any position reference. If position is omitted, general schema usage 
is reactivated with the defaults in effect as described above. 

fid is a valid file identifier. 

Descr i pt ion: 

This command is used: 

1. To reactivate schema usage that has been deactivated by the SCHEMA option of the 
KILL command. 

2. To specify the current schema for all nonqualified position or location references. 

There is always some default in effect regarding the current schema unless general 
schema usage has been deactivated by the SCHEMA option of the KILL command. These are: 

1. In the debug mode, the current schema is the one associated with the ECU indicated 
by the contents of the Instruction Counter (IC). 

2. In the RUM mode, the current schema is the one associated with the ECU which 
contains the start address of the run unit. 
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Example: 

Di rect i ve 
SCHEMA 

SCHEMA PR0BNAME:556 



Explanation 

Reactivate general schema usage and default 
to the current schema as per IC. 

Consider the schema associated with PR0BNAME:556 
the current schema. 



Cross Reference: 

See the ALTERNATE VARIABLES command. 

USE NODE Command 



Format 



U[SE] 



jN[ODE] nodename 
I [CURRENT] 



Parameters: 

nodename specifies the name of an overlay node. When CURRENT is specified the 
schemata for the overlay nodes currently in memory are re-established. 

Descr i pt i on : 

The USE command is used to specify the name of a program overlay when running in the 
debug or RUM mode of DELTA. 

When the command is issued, the schemata associated with the overlay node and its 
backward path are activated so that symbolic references may be made using symbols 
defined within the overlay schemata. 

Special Considerations: 

The USE NODE command sets breakpoints at procedure positions within overlay nodes that 
are not in memory. This command prevents waiting for those operations until the overlay 
node is loaded into memory. DELTA does not, however, prevent an attempt to modify a 
location by using a symbolic location reference in either the LET or MODIFY command. If 
the overlay node named in the USE NODE command is not actually in memory, the contents 
of memory which that symbol would occupy if it were in memory will be changed and no 
warning would be issued by DELTA. To modify a location in a overlay node not in memory, 
the ON NODE command is used to cause a breakpoint when the overlay node is loaded. See 
the Usage Notes for more information. 

Exampl e : 

Assume that the target run unit consists of five ECU's in the following tree structure: 



NDBAKER -ECUB-ECUC 



NDABLE — ECUA- 



NDDOG -ECUD-ECUE 
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where 
NDABLE 
NDBAKER 
NDDOG 



is a node containing an external compile unit ECUA. 
is a node containing ECUB and ECUC. 
is a node containing ECUD and ECUE. 



Upon initial entry to DELTA, the user wishes to establish breakpoints at statement 
number 50 in ECUB, statement number 100 in ECUE, and statement number 50 in ECUA. 



Command 
AT 50 

USE NODE NDBAKER 
AT ECUB: 50 

USE NODE NDDOG 
AT ECUE: 100 

Usage Notes: 



Exp I anat i on 

Having entered DELTA, the root node (NDABLE) 
is in memory and ECUA is implicit; therefore, 
no qualification was necessary. 

NDBAKER is the node name for the set of ECU's 
ECUB and ECUC. 

Qualification is required to distinguish 
statement number 50 in ECUB from statement 
number 50 in ECUC and ECUA. 

This specifies the node containing ECUE. 

ECUE is used to qualify the desired statement 
number. 



1. When USE NODE is used in the RUM mode, the overlay is made to look as if it is in 
memory, i. e., instructions and data are brought in as well as schema. Any 
modifications made while USE NODE is in effect will be made to the location in the 
named overlay node, and not to the root node. 

2. The USE NODE command is not allowed for FEP programs. 



ALTERNATE VARIABLES Command 

Format: 

ALTERNATE] VARIABLES] position 
Parameters: 

position may be expressed as either a primary or secondary entry name. 
Description: 

This command is used to specify an alternate schema to be searched by DELTA whenever a 
search for a location (variable) reference is not satisfied within the current schema. 

The command can be used to great benefit during debugging sessions whose target run 
units are composed of two or more ECU's. Through use of this command, references to 
both global and based variables may be made without ECU qualification. 
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Example: 

Command Explanation 

ALTERNATE VARIABLES ENTRYNAME Search the schema associated with 

ENTRYNAME whenever a search 
within the current schema has failed. 

Usage Notes: 

1. The ALTERNATE VARIABLES schema is always searched as a last resort when DELTA tries 
to satisfy a variable reference (MODIFY, LET, DISPLAY, FIND, STORE, DUMP commands). 

2. For COBOL and FORTRAN programs, the initial default for position is the ECU that 
contains the run unit's start address. For all other programs, the initial default 
position is the entry name B_DELTA_D. 

Cross Reference: 

See the SCHEMA command (position option). 



FORMAT Command 

Format : 

FOR [MAT] |M[ODIFY] \ \f 
|E[VALUATE]| 

Parameters: 



f is one of 


the specifiers in Table 3-1. 






Tab I e 3-1 . Format 


Spec i f i e rs 


Spec i f i er 


Mean i ng 


Exampl e 


A[R] 


Display left 24 bits of a 
word as word-char-bit. 


.35-2-5 


B[IT] 


Display in binary format. 


•0101 10100'B 


C[HAR] 


Character. 


' ABCD ' 


D[ESCR] 


Descriptor. 


. 46000, BD=. 75777-3, 
FL=.643,WSR=7,TY=0 


EB[CDIC] 


EBCDIC Character 


*694E' 


E[PTR] 


Displays left half of word 
as ENTDEF+. of f set [ : stmnt#] 


PROGB+.374 :27 


F[LOAT] 


Floating point binary. 
Single precision for 
36-bit items, double 
precision for 72-bit 
i terns. 


5.789604E+76 


I[NSTR] 


Assembly language 
inst ruct ion. 


LDQ .1.DL 
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Tab I e 3-1 . Format 


Specifiers (cont.) 


i r r\r 1 

J[DE] 


JIT Dot ERR. Displays 
error message for the 
value stored in JIT. ERR. 


FMN-M00113-0 

File does not exist 


0[CTAL] 


Octal digits with leading 
zeroes suppressed. 


.1024 


P[TR] 


Pointer, word-char-bit, 
segid. 


. 35-2-7, $LS0 


REEL] 


Relative. Primary ENTDEF+ 
of f set l , : stmnty , suostmnt, 
offset] or SYMDEF + offset 


PR0GA+.6 :12, , .1(L00P) 


REMEMBER J 


Remembe r . 


TEST : o{ LABEL; [ASSIGNMENT J {+ . 4} 


S[BIN] 


Signed binary (decimal). 


-357 


T[IME] 


Convert UTS to display 
format . 


13:52:36.82 06/25/79 


U[BIN] 


Unsigned binary (decimal). 


357 


V[ ECTOR] 


Vector . 


. 6245-0-0 , $ LS0 , BD= . 1 4-2 , 
FL= . 777 , TY=N0RMAL SHRINK 


X 


Hexadecimal . 


*F100CS40D'X 


X1 


Pseudo-hexadecimal . 
ignored. 


*F0F8F6F4'X 


Z[ERO] 


Displays a word value in 
Octal with leading zeroes. 


.000000001024 



Descr i pt i on: 

The FORMAT command establishes the default display for the EVALUATE and MODIFY commands. 
The normal display format for these commands is octal with leading zeros suppressed. 

DEFINE Command 

Format : 

DE[FINE] symbol expression 
Parameters: 

symbol is a symbol name up to 30 characters in length. 

expression is any address expression which results in a value. Overflow is ignored, 
and only the least significant 36 bits of the value are saved. 
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Descri pt ion: 



The DEFINE command associates a symbolic name with a value, allowing the symbol to be 
used whenever the associated value is desired. This is particularly useful for defining 
addresses in programs that do not have debug schema. 

Example: 

DEFINE HEP .14136 
DEFINE HEPMORE HEP+.2C1 

Usage Notes: 

1. A DEFINED symbol may be removed with the DEF option of the KILL command. 

2. DEFINE cannot be used to define replacement names for ENTDEFs. An ENTDEF (primary 
entry definition, secondary entry definition, ECU name) is a special entity which 
has schema associated. A symbol name defined with DEFINE has no associated schema. 
Therefore, whi le: 

MOD I FY VERYLONGENTRYNAME : 23 
and 

DEF VLEN VERYLONGENTRYNAME 
are meaningful, MODIFY VLEN:23 is not. 



RANGE Command 

Format : 

RA[NGE] value 
Parameters: 

value is any octal or decimal literal. The default is .7777. 
Description: 

Sets the maximum position range DELTA will use when determining whether to print a 
location as an octal location, or as the closest of a user DEF + offset or SYMDEF + 
offset . 

Example: 

DEF A .30 
RANGE .40 

When modifying location .70, DELTA will write A+.40, but modifying location .71 results 
in .71 . 



REPORT Command 

Format : 

REPfORT] [compiler] [info] 
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Parameters : 

compiler is one of the following: 

G[MAP] 

P L6] 

F[ORTRAN] 

FP[L] 

C[OBOL] 

PL1 

R[PG] 

If compiler is omitted, the info field applies to all compilers. 

info is one of the following: 

A[LL] 
D[EFAULT] 

or any combination of 0[FFSET, L[ INE] , or T[YPE], separated by commas. If info is 
omitted, the info field is treated as DEFAULT. 

A complete position report consists of the following fields: 

Primary +. offset :line# ( I abe I ) , substmnt# , . of f set [TYPE] /GMAP6 instruction 
ENTDEF \ A A A / 

Field 1 2 3 4 

Display of fields 1 and 4 is enabled by specifying OFFSET. 

Display of field 2 is enabled by specifying LINE. 

Display of field 3 is enabled by specifying TYPE. 

Field 4 is available only when the report is generated as the result of a STEP command. 
Desc r i pt i on : 

The REPORT command controls the manner in which DELTA displays position references. 
DELTA normally displays position reference information based upon what compiler produced 
the object unit from which the current position is being displayed. 

Examp I e : 

REPORT ALL 

REPORT PL6 OFFSET, LINE 
REPORT COBOL ALL 

Usage Notes: 

1. Schema is required for the REPORT command to have any effect. If schema has been 
KILLed, or if the object unit that contains the position reference being displayed 
by DELTA does not have any debug schema associated with it, the REPORT will be 
identical to REPORT GMAP, i.e., 

def +. offset (label) 

where def is the closest primary ENTDEF; or if there are no ENTDEFs less than or 
equal to the position, def is a user defined symbol (subject to RANGE). 

label is an exact matching secondary ENTDEF or SYMDEF. 

2. The initial defaults for REPORT as a function of compiler type may be displayed by 
using the REPORT option of the SHOW command when DELTA is first entered. 



CE39-03 



REPORT Command 



3-13 



Stored Command Management Commands 

The stored command management commands include the following: 
KILL/SHOW, S I LENT/UNS I LENT , ACTIVE/ INACTIVE, UPDATE, SAVE, DO 

This category of housekeeping commands allows the user to exercise control over and 
remain cognizant of up to 99 stored commands and to set and reset the status of those 
toggle options detailed throughout this section. 

Within this category are commands which control the "noise level" at a terminal 

(SI LENT/UNS I LENT) . Breakpoints which are serving a useful purpose but whose reporting 

is no longer necessary may be silenced. 

Breakpoints which have been entered but are not useful in a given debugging situation 
may be temporarily inactivated and then activated again at a later time without having 
to re-enter them (ACTIVE, INACTIVE). 

Commands which are to be executed often may be saved as though they were attached to 
breakpoint commands and directly invoked whenever necessory (SAVE). 

The KILL command revokes actions which have been taken previously and the SHOW command 
displays both the status of toggles and the text of stored commands. 



KILL/SHOW Command 



Format : 

}K[ILL] i jid[-id] \ 
jSH[OW]j jid [TO id][ 
{keyword { 

Parameters: 

id is the identification of a stored command, 
keyword is one of the keywords in Table 3-2. 



Table 3-2. Keywords Used with KILL and SHOW 


Keyword 


Meani ng with Kill 


Mean i ng with Show 


AL[L] 


Remove a 1 1 stored 
commands. 


Display status of all 
stored commands, toggle 
options, and modes. 


A[ LTERNATE] 
V[ARIABLES] 


Discontinue use of 
alternate variables. 


Show status of toggle and 
schema name if any. 


AN[LZ] 


Return to debug mode. 


Show status of toggle. 


A[TS] 


Remove all AT breakpoints 
and their attachments. 


Display all AT breakpoints 
and their attachments. 


B[YPASS] 


Do not bypass step 
reporting in assembler 
modules. 


Show status of toggle. 


C[OPY] 


Discontinue COPYing. 


Show status of toggle. 
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Table 3-2. Keywords Used with KILL and SHOW (cont.) 


Keyword 


Meaning wi th Kill 


Meani ng with Show 


D[EF] 


Remove a specific named 
DEFINED symbol. 


Not appl icable. 


DEFS 


Remove all DEFINED symbols. 


Display al 1 defined 
symbo 1 s . 


DEL[TA] 


Causes DELTA to be 
disassociated from the 
current run unit being 
debugged. 


Not appl icable. 


EC [HO] 


Discontinue ECHOing. 


Show status of toggle. 


E[OM] 


Deactivate the EOM 
character set. 


Show status of toggle. 


F[ORMAT] 


Set display formats for 
MODIFY and EVAL back to 
initial def au 1 ts. 


Display current default 
formats for MODIFY and 
EVAL. 


I [GNORE] 


Not appl icable. 


Display which exceptional 
condition groups and/or 
names are being ignored. 


K[EEP] 


Not appl icable. 


Display which exceptional 
condi t ions will be 
intercepted and reported 
by DELTA. 


0[N] A[BORT] 


Remove ON ABORT 
breakpoint and its 
attachments . 


Display ON ABORT breakpoint 
and its attachments. 


0[N] C[ALLS] 


Remove all ON CALL(S) 
commands and their 
attachments. 


Display all ON CALL(S) 
commands and their 
attachments. 


0[N] E[XIT] 


Remove ON EXIT breakpoint 
and its attachments. 


Display ON EXIT breakpoint 
and its attachments. 


0[N] N[ODES] 


Remove all ON NODE(S) 
commands and their 
attachments. 


Display all ON NODE(S) 
commands and their 
attachments. 


P[ROTECT] 


Discontinue PROTECT mode. 


Display PROTECT mode. 


R[ANGE] 


Not appl icable. 


Display value of range 
specification for relation 
posi t i on report i ng . 


REfPORT] 


Not appl icable. 


Display reporting mode 
for position reporting. 


RU[M] 


Return to debug mode. 


Show status of toggle. 


SAD 


Not nnn 1 i rnh 1 a 


Display special access 
descriptor number. 


SA[VES] 


Remove all SAVE commands 
and their attachments. 


Display all SAVE commands 
and their attachments. 
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Table 3-2. Keywords Used with KILL and SHOW (cont.) 


Keyword 


Meaning with Kill 


Meaning with Show 


SC[HEMA] 


Discontinue schema usage. 


Display the position which 
defines the current schema, 
as set by the instruction 
counter or the SCHEMA 
command. 


S[TEP] 


Default to step by 
statement. 


Show status of STEP mode. 


SY[NTAX] 


Not appl i cable. 


Display which input 
syntax DELTA is currently 
accepting. 


T[RACE] 


Discontinue tracing. 


Display all TRACE 
commands . 


TRAP 


Not appl i cabl e . 


Display which exceptional 
conditions will be passed 
to the trap handler in the 
target run unit. 


W[HENS] 


Remove a 1 1 WHEN 
breakpoi nts and 
thei r attachments. 


Display all WHEN 
breakpoints and their 
attachments. 


FEP Keywords: 






DEL[TA] fprg-res 


Causes DELTA to be 
disassociated from the 
specified FEP program. 


Not appl icable 


FP[RGS] 


Not App 1 i cab 1 e . 


Displays the state 
of all exi st i ng FEP 
programs being debugged. 


fprg-res 


Not Appl i cabl e 


Display the state 
of the specified FEP 
program. 



Desc r i pt i on : 

The KILL command is used either to change the status of a toggle or to cancel a 
previously entered command. 

The SHOW command is used to display the status of a toggle, classes of commands and 
attachments, and the current disposition of exceptional conditions. 
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SILENT/UNSILENT Command 

Format : 



|SI[LENT] i 
|UN[SILENT]i 

Descr i pt i on : 



These commands control the reporting of active breakpoints. They silence redundant 
reporting once the user determines that a breakpoint or a range of breakpoints is 
achieving the desired results. 

Examp I e : 

Command Explanation 

SILENT 10-15 Silence the reporting of the 

breakpoints in the range 
spec i f i ed. 

UNSI LENT 10-15 Resume reporting of the 

breakpoints in the specified 
range . 

SILENT 7 Silence stored command number 7. 

Usage Notes: 

1. SILENT may also be specified as an option of the AT command in the following manner: 

[id] ATS ROUTINE10[;attachment] ... 

All attachments to a silent breakpoint function normally except MODIFY. The display 
of the old contents of the modified location is inhibited. 



ACTIVE/INACTIVE Command 



Format : 

AC[TIVE] } id [-id 1 
IN[ACTIVE]| [TO id] 

Descr i pt i on: 

These commands set stored commands to either an active or inactive status. An active 
breakpoint is one which is still in effect. An inactive breakpoint is one which is no 
longer in effect. An inactive breakpoint is remembered by DELTA, however, and will 
still maintain its identification number. 

Example: 

Command Explanation 

ACTIVE 10-15 Set the specified range of inactive 

breakpoints to an active status. 

INACTIVE 10-15 Set the specified range of active 

breakpoints to an inactive status. 
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Usage Notes: 

1. INACTIVE may also be specified as part of the AT command in the following manner: 

[id] ATI ROUTINE10[;attachment] ... 

Attachments to an inactive breakpoint will not function until the breakpoint is 
activated again, since an inactive breakpoint is never hit. 

UPDATE Closed Form Command 
Format : 

UP[DATE] id[ ,m] text 
Parameters: 

id is the identification of a stored command, 
m is the attachment number. 

text is the text to replace attachment m of stored command id. 
Descript ion: 

The UPDATE command replaces attachment m of the specified stored command with 
replacement text. Attachment zero is the stored command. If attachment m does not 
exist an error message is given. If m is not specified, the replacement text is added 
as an attachment to the end of the specified stored command. If attachment m is 
replaced with all blanks, attachment m is deleted. 

Example: 

Command Explanation 

UPDATE 1,2 DI ALPHA Replace the second attachment of stored 

command 1 with the text *DI ALPHA* 

UPDATE 3 PLUGH Add the text 'PLUGH* as an attachment to 

the end of stored command 3. 

UPDATE 2,0 AT PROG: 100 Replace stored command 2 with the text 

•AT PROG: 100' 

UPDATE Open Form Command 

Fo rma t : 

UP[DATE][A] id[-id] 
or 

UP[DATE] id.m 
Parameters: 

id is the identification of a stored command. 

A indicates that UPDATEing is to be done an attachment at a time, 
m is the attachment number. 
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Descr i pt i on : 



The first format displays stored commands id to id, stopping at the end of each to allow 
modification of the stored command. If A is specified, for stored commands id to id, an 
attachment at a time will be printed, stopping at the end of each attachment to allow 
modification. Entering linefeed causes the next attachment or stored command to be 
displayed stopping at the end to allow modification. Entering t causes the previous 
attachment or stored command to be displayed stopping at the end to allow modification. 
A carriage return ends updating on the current stored command. If a stored command is 
greater than 256 characters in length and A was not specified, a message will be given 
and the stored command will be updated one attachment at a time. 



The second format, wi I I print attachment m of stored command 
allow modification of that attachment. 



id, stopping at the end to 



Examp I e : 

Command 
UPDATE 1-4 



Exp I anat i on 

Prints the stored commands in the 
range specified stopping at the end of 
each to allow modification. 



UPDATEA 5-10 



The stored commands in the range 
specified are printed an attachment at 
a time stopping at the end of each 
attachment to allow modification. 



UPDATE 3,2 



Prints the second attachment of stored 
command 3 stopping at the end to allow 
modification of that attachment. 



SAVE Command 

Format : 

[id] SA[VE];attachment[;attachment] ... 
Descr i pt ion: 

This command is a keystroke saver. It saves attachable commands as though they were 
attached to a breakpoint. The SAVEed attachments may then be executed by referring to 
their id in a DO command. 



DO Command 
Format : 
DO id 

Parameters: 

id is the identifier of any stored command. 
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Descri pt ion: 



The DO command performs the attachments to any stored command. This includes 
attachments saved with the SAVE command'and the attachments to any breakpoint command 
whether active or inactive. 

Usage Notes: 

1. The DO command is itself attachable, and allows an IF specification. This allows 
very complex, and possibly recursive, chains of attachments. The user must take 
care to avoid recursions which will never exit. The BREAK key can be used to stop 
an endless attachment loop. 

Fault and Trap Control Commands 

The fault and trap control commands include the following: 

KEEP/TRAP/IGNORE, ON EXIT/ON ABORT 

One of the functions of DELTA is to capture all faults, traps, asynchronous entries, 
normal exits, and abnormal exits which might occur during execution of your program. 
These are collectively referred to as exceptional conditions (ECs) by DELTA. 

The action taken by DELTA when an EC occurs is controlled in part by the commands 
described in this category. The user has the choice of having DELTA report the type and 
position of the EC (KEEP), ignore the EC (IGNORE), or pass the EC to a handler in the 
user's program (TRAP). The user may also specify a list of attachments to be executed 
when an exit condition occurs (ON EXIT, ON ABORT). 

KEEP/TRAP/IGNORE"Command 

Format : 



KE[EP] 
TRAP 
IG[NORE] 



AL[L] 
N[ONE] 

categoryf , category] 
type[,typel ... 
H[OST] AL[Ll 
h'ost' N[ONEJ 
H[OST] typef.type] 



fprg-res Al[l] 
fprg-res N[ONE] 
fprg-res type[,type] 

Parameters: 

ALL specifies all categories and types are to be added to this list. 

NONE specifies all categories and types are to be removed from this 
list. 



category specifies a category to add to this list. 
(Categories are in Table 3-3. 

All types in a category may be placed on a list 
by using the category name.) 

type specifies a type to add to this list. 
(Types are listed in Table 3-3. 

FEP exceptional condition types are listed in Table 3-4.) 
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FEP Parameters: 

Host specifies the host program 

fprg-res specifies a particular FEP program. This is the value 
the user specified for the RES on the M$OPEN of the FEP program. 



Table 3-3. Exceptional Condition Types By Category 



CATEGORY 
MO[NITOR] 



AR[ ITHMETIC] 
PR[OGRAMMED] 

ER[ROR] 



EC TYPE 

T[ IMER 
EV[ENT 

b[reak 

X[CONl 
PM[MEJ 



(Bad PMME, no ALTRET) 



OV[ERFLOW] 

DI[VIDE_CHECK] (Divide check) 

MM[E] 

DE[RAIL] 

F[AULT_TAG] 

ME[MORY] 

CO[MMAND] 

LrOCKUP] 

l[PR] (Illegal Procedure) 
SEG (Missing Segment) 

0 



PA[GE] (Missing Page] 
SEC_1 (Security 1] 
SEC_2 (Security 2] 



APPLICABLE 
MONITOR SVC 

M$STIMER 
M$ EVENT 
M$INT 
M$XCON 
M$TRAP 

M$TRAP 
M$TRAP 

M$TRAP 
M$TRAP 
M$TRAP 

M$TRAP 
M$TRAP 
M$TRAP 
M$TRAP 
M$TRAP 
M$TRAP 
M$TRAP 
M$TRAP 





Table 3-4. 


FEP Exceptional Condition Types 


EC TYPE 




APPLICABLE 
MONITOR SERVICE 


EV[ENT] 




M$ EVENT 


B[REAK] 




M$INT 


X[CON] 




M$XCON 


M[CL] (Bad MCL. 


no ALTRET) 


M$TRAP 


T[RAP] 




M$TRAP 
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Desc r i pt i on : 

KEEP/TRAP/IGNORE are used to build a list of EC types which will be handled in one of 
three ways. 

If an EC type is on the KEEP list when an EC of that type occurs, it is reported, along 

with the current position. If an EC is on the TRAP list when an EC of that type occurs, 
it will be passed to the user program's handler for that EC type. If an EC is on the 

IGNORE list when an EC of that type occurs, the program IC is adjusted to avoid 

re-occurrence of the EC and control returns to the program at the new position. 

To remove an EC type from one list, the user specifies that it is to be placed on some 
other list. To remove all EC types from a list, the user specifies NONE for that list. 
Any EC types that were on a NONEed list are placed on the KEEP list. 

Usage Notes: 

1. Use of a category name implies all types in that category. Types and categories may 
be mixed freely on a line, e.g., TRAP MONITOR, DIVIDE. 

2. If, at the time of an occurrence of an EC on the TRAP list, a program does not have 
a valid handler for that EC, an error message will be issued. DELTA will continue 
as if that EC had been on the KEEP list. 

3. Precedence is given to ON EXIT/ON ABORT for the XCON EC. 

4. When there are FEP programs associated, the commands have the following meanings: 

KEEP ALL report everything on all programs - Host and FEP. 

KEEP HOST ALL report everything on the Host program. 

KEEP fprg-res ALL report everyting on the specified FEP program. 

KEEP HOST EVENT report event exceptional conditions on the Host program. 

TRAP ALL passes exceptional conditions on all programs to the program's trap 
handler - this does not include the start of FEP programs. 

TRAP HOST ALL passes exceptional conditions on the Host program to the Host 
program's trap handler. 

TRAP fprg-res ALL passes exceptional conditions on the specified FEP program 
to the specified FEP program's trap handler. 

TRAP fprg-res MCL only pass MCL exceptional conditions for the specified FEP 
program to the specified FEP program's trap handler. 

IGNORE ALL reports no exceptional conditions on all programs. 

IGNORE HOST ALL reports no exceptional conditions on the Host program. 

IGNORE fprg-res ALL reports no exceptional conditions on the specified FEP 
program. 

IGNORE HOST BREAK reports no BREAK type exceptional conditions on the Host 
program. 
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ON EXIT/ON ABORT Command 



Format : 

id] 0[N] A[BORT] [cond i t i on] [; attachment] ... 
id] 0[NJ E[XIT] [condition][;attachment] ... 

Desc r i pt i on : 

These commands are primarily intended for use by the non i nteract i ve user (batch mode or 
online !XEQ) who wishes to specify an action to be taken when his program aborts or 
exits unexpectedly. ON EXIT specifies a list of attachments to execute when an EXIT 
condition is encountered, ON ABORT specifies a list of attachments to execute on an 
abort condition. 

An EXIT condition can be caused by M$EXIT, M$SAVE, and M$LDTRC. An abort condition can 
be caused by M$ERR, M$XXX or a monitor abort for limit exceeded. 

Examp I e : 

ON ABORT ;DU $TCB->0.64;Q 

When an abort occurs, dump the top TCB frame, and then exit DELTA. 

Usage Notes: 

1. ON ABORT and ON EXIT are stored commands. They can be displayed and killed using 
SHOW id and KILL id. 

2. ON ABORT and ON EXIT take precedence over KEEP/TRAP/ IGNORE, i.e., even though TRAP 
XCON was specified, the attachments for ON ABORT or ON EXIT will be executed if an 
XCON EC (Exceptional Condition) occurs. If the user wishes to pass control to an 
XCON handler in his program after the attachments are executed, he attaches a GOTRAP 
command . 

3. ON ABORT is not allowed for FEP programs. 



Miscellaneous Housekeeping Commands 

The miscellaneous housekeeping commands include the following: 
BYPASS, PROTECT, SAD 

This category of commands provides additional facilities that do not easily fall into 
any of the other categories of housekeeping commands. Commands are provided to: 

1. Control stepping through GMAP6 modules. 

2. Avoid inadvertent modification to memory locations. 

3. Allow access via descriptors from the monitor's linkage segment. 
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BYPASS Command 

Format : 



BY [PASS] 
Descri pt ion: 

This command is used to specify that DELTA is to skip step reporting while stepping 
assembly language program units. This is useful for PL-6 ECU'S which call assembly 
language routines. When BYPASS is specified, all subsequent STEPs will not stop in 
assembly language modules, but will stop at the first instruction/statement after 
exiting from the bypassed module. BYPASS is the default unless the start address is in 
an assembly language routine; then the default is KILL BYPASS. 

Usage Notes: 

1. BYPASS is a toggle. It is reset with the BYPASS option of the KILL command. 



PROTECT Command 
Format : 
PROT[ECT] 
Description: 

This command is used to specify that DELTA is not to modify memory locations as 
specified by the MODIFY, LET, FIND, or STORE commands. The command is most often used 
when the interactive form of the MODIFY command is used to examine a run unit image in 
RUM mode, or when the running monitor is being examined in ANLZ mode, and the user 
wishes to insure that a typing error will not cause a memory location to be changed 
inadvertently. KILL PROTECT is the default. 

Usage Notes: 

1. PROTECT is a toggle. It is reset with the PROTECT option of the KILL command. 



SAD Command 

Formot : 
SAD n 

Parameters: 

n is a decimal or octal number. 
Descript ion: 

This command specifies which descriptor from the monitor's linkage segment is to be 
associated with the special symbol $SAD. (See the Monitor Services Reference Manual 
(CE33) M$SAD description for more information regarding special access descriptors.) 
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Usage Notes: 

1. The SAD option of the SHOW command is used to display the currently associated 
descriptor number. 

2. The SAD command is not allowed for FEP programs. 
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Section 4 
Execution Control 



This set of commands allows the user to specify that DELTA is to assume control of an 
executing run unit at any of the following times: 

o When control passes to a procedure position (AT). 

o When an elementary item or location is modified (WHEN). 

o When the BREAK key is depressed. 

o When one program unit CALLS another program unit (ON CALL), 

o When an overlay node is loaded (ON NODE). 

o When an exceptional condition occurs. (See the discussion on Fault and Trap Control 
Commands in Section 3.) 

Once DELTA has assumed control and issued its prompt character, the user may then 
specify that execution is to resume at the same location; specify whether or not to 
proceed with execution by instruction or by statement; or issue any command in DELTA'S 
repertoi re. 

Execution Control commands are divided into the following categories: 

o Procedure breakpoint commands 

o Data breakpoint command 

o Transfer of control commands 

o Procedure stepping commands 

o Special purpose execution commands 

Procedure Breakpoint Commands 

Procedure breakpoint commands include the following: 

AT. ON NODE/ON NODES. ON CALL/ON CALLS. 

A procedure breakpoint occurs on the arrival of the Instruction Counter (IC) at a 
designated position (AT, ON CALL); on the general occurrence of CALLS (ON CALLS); or on 
the loading of an overlay node (ON NODE, ON NODES). 
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AT Command 

Format : 

[id] A[T][I][S] position [#n] [condition] ^attachment] ... 
Parameters : 

id is a decimal number from 1 to 99 which identifies the AT command. 

I indicates that the breakpoint is to be inactive (see the INACTIVE command). 

S indicates that the breakpoint is to be silent (see the SILENT command). 

#n specifies the number of times to BYPASS the breakpoint with a true CONDITION 
before allowing it to be executed. 

condition is an IF attachment. 

Description: 

The AT command conditionally or uncondi tona I I y interrupts execution at a specific 
position in the logical flow of a run unit. 

Examp I e : 

Command Explanation 

AT P:100 Sets a breakpoint at statement number 

100 in ECU P. 

AT P:100;DISPLAY X;GO At P:100 the value of X is printed and 

execution is resumed. 

10 AT P:100 IF X EQ 0;DISPLAY Y The AT command has an id of 10. At 

P:100 if X equals 0, the value of Y is 
printed and DELTA reads its next 
command. If X is not equal to 0, 
execution resumes without 
interruption. 

AT :7 #6; LET A 1; GO Conditional execution is specified 

by using a bypass count (#6). The 
breakpoint will be bypassed six 
times, then reported and executed 
on the seventh time. 

AT :10 IF A GT 20; Multiple levels of cond i t i ona I i ty are 

specified using the IF conditional. 
Both the reporting of this breakpoint 

LET B 0 IF C > 10; and the execution of its attachments 

are dependent upon the truth of the 

LET B 1 IF C LE 10; first IF conditional. 

When the first condition is true, the 

GO THERE IF B EQ 1; GO breakpoint is reported and the 

attachments are examined. The 
The attachments are executed only when 
their associated IF condition is true. 



The previous example translates to the following pseudo code: 
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10: 
11 : 
12: 
13: 
14: 
15: 



THEN DO; 

IF C > 10 THEN B = 0; 
IF C <= 10 THEN B - 1 ; 
IF B = 1 THEN GOTO THERE; 
END; 



IF A > 20 



Usage Notes: 

1. When both BYPASS and IF are specified, the bypass count is decremented only when the 
IF condition is true. The breakpoint will be reported on occurrence n+1 of the true 
condi t ion. 

2. When the INACTIVE or SILENT options are specified, no space character is allowed 
between the AT and the option (e.g., ATS or AS means AT, SILENT). 

3. All executable statements and static data are located in the Instruction Segment of 
a run unit. The AT command should always specify the address of an executable 
instruction. Because of the way that position may be specifed (symbols, octal 
addresses, decimal addresses, expressions), DELTA cannot guarantee that this 
requirement is met. DELTA places a breakpoint at the position to which the 
expression is resolved. Should this position not be an executable instruction, then 
the breakpoint will not occur and it is possible that the placement of the 
breakpoint may alter a word of data within the run unit. Should this happen, the 
results will be unpredictable. Special care should be exercised to avoid setting a 
breakpoint in the arguments of a calling sequence which are often intermingled with 
the executable instructions. Specification of a breakpoint using a program 
statement number or label will always perform correctly. 

4. To continue execution from the point of interruption, use the GO command with no 
position specified. If you use GO position where position is the current IC, i.e., 
where the breakpoint occurred, the breakpoint will immediately re-occur. Any other 
execution resuming command can be used (that is, STEP, GOSTEP, XCON, BREAK, or GO 
position where position is not the current IC) . 

5. The same position may not be used in two different ATs at the same time; i.e., 

3 AT 10;DISPLAY A;GO 

4 AT 10;DISPLAY B;GO 

i s not va I id. 



Format: 
General Form: 

[id] 0[N] N[ODES] [cond i t i on] [ ; attachment] ... 
Specific Form: 

[id] 0[N] N[ODE] name [cond i t i on] [ ; attachment] ... 
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ON NODE, ON NODES Commands 



Parameters: 

id is a decimal number from 1 to 99. 

condition is an IF conditional which must be true for the breakpoint to occur, 
name is the name of an overlay node. 
Descript ion: 

The ON NODE command conditionally interrupts execution when an overlay is loaded. 
Usage Notes: 

1. When the general and a specific form of the command are active, they are mutually 
exclusive. The specific form is not activated unless the named overlay is loaded. 
The general form is not activated when any overlay named in a specific form of the 
command is loaded. 

2. Only one general form is permitted, but many specific forms may be active. 

3. The breakpoint occurs on the M$OLAY monitor service and $IC points to the 
instruction immediately after the CLIMB instruction. 

4. The ON NODE(S) command is not allowed for FEP programs. 

ON CALL, ON CALLS Commands 

Format : 
General Form: 

[id] 0[N] [X] C[ALLS] [condition][;attachment] ... 
Specific Form: 

[id] 0[N] C[ALL] name [cond i t i on] [ ; at tachment ] ... 
Parameters : 

id is a decimal number from 1 to 99. 

X specifies breakpoints on external procedure calls only. 

condition is an IF conditional which must be true before the breakpoint is to occur, 
name is the name of a program unit. 
Descript ion: 

The ON CALL command allows the user to conditionally interrupt execution prior to entry 
of a CALLed program unit. 

Usage Notes: 

1. When the general and a specific form of the command are active, they are mutually 
exclusive. The specific form is not activated unless the named program unit is 
CALLed. The general form is not activated when any program unit named in a specific 
form of the command is called. 

2. Only one general form is permitted, but many specific forms may be active. 

3. The breakpoint occurs before execution of the first instruction of the called 
program unit. The $IC points to the first instruction of the called program unit. 
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Data Breakpoint Command 

WHEN is the data breakpoint command. 

A data breakpoint occurs when the value of a variable changes during the execution of 
the program. DELTA can be told to stop when any change is made to the variable, or only 
when the new value fits a given relation with the specified constant. 



WHEN Command 

Format : 

[id] W[HEN] item [relation constant] [#n] 

[condi t ion][ ; attachment[; attachment] ... ] 

Parameters : 

id is a decimal number from 1 to 99. 

item is an elementary item, structure or substructure, or single element of an array. 
A range of array subscripts may not be specified. The complete specification for item 
can be found in the section called Memory Display and Modification. 

relation any of the relations legal in the IF attachment described earlier .e.g., =, 
>, <, GT. LE, etc. 

constant any of the literal constants known to DELTA, e.g., 7, 'ABCD', 2.2, *0'B, 
.134. etc. 

#n specifies the number of times to bypass the breakpoint with a true condition 
before allowing it to be executed. 

condition an IF attachment. 

Descr i pt i on : 

This stored command causes data breakpoints to occur when the value of a named variable 
or structure changes. 

Example: 

In the examples in this subsection, assume the following program section is defined: 

DCL 1 LEN.REC STATIC, 
2 NAME, 

3 LN CHAR(12), 

3 FN CHAR(10), 

3 MI CHAR(1), 
2 SSN CHAR(9); 

Command Explanation 

WHEN SSN Halt execution when the value of SSN changes 

from the value it had when the command was 
first issued. Both of the following statements 
could cause the example data breakpoint to be 
hit: 

SSN = ' • ; 
LEN_REC = IN.REC; 
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WHEN FN EQ '**' 



Halt execution when the volue of FN is changed 
to ***'. Note that if FN is equal to '**' when 
the command is issued, the data breakpoint 
will not be hit until FN is changed to 
something other than '***, and then back to 
'*** . 



WHEN SSN= ' 999999999* ; 
DISPLAY NAME; GO 



Usage Notes: 



This example shows that attachments can be made 
to WHEN in the same manner as the AT command. 
The IF conditional may also be used. 



1. If more than one data breakpoint variable is changed at the same time, only the 

breakpoint with the smallest ID is considered to be hit. For example, consider the 
following two breakpoints, using the structure defined above: 



4 WHEN NAME 

5 WHEN SSN 



The statement MOVE SPACE TO LEN_REC would cause only breakpoint 4 to be hit, and not 
5, even though the value of SSN may have changed. If NAME was already equal to 
space, but SSN was pot, breakpoint 5 would be hit in this example, since the value 
of NAME did not change. 

2. While duplicate positions are not legal for multiple AT commands, duplicate 
variables may be specified for WHEN, e.g., 



WHEN A>10 
WHEN A<4 



can exist together. If two or more data breakpoints are hit at the same time 
(overlapping conditions or data), only the first (smallest id) will be honored. 

3. If a variable is used as a subscript for an array, the va I ue of the variable 
subscript is stored in the WHEN command, and not the variable. For example, assume 
the value of A is 7. WHEN ARRAY (A) is stored as WHEN ARRAY (7) by DELTA. 

4. Data breakpoints are very costly in terms of computer resources. They will greatly 
increase the execution time of the program, more so than any other DELTA command. 
DELTA works with the CP-6 monitor to watch the variables in the program change in 
value. The smallest area of memory that can be watched is a page (that is 1,024 
words) of memory. This means that if WHEN A is specified, DELTA is notified anytime 
anything on the page or pages containing A is modified. DELTA then checks to see if 
the value of A has changed. If all of the variables in the program are stored in 
the same page of memory, DELTA is entered every time any variable is modified, or 
just about every statement. 

Always try to localize the area of the program that is to monitor a variable. For 
example, assume you, the user, are only interested in changes made to A between 
statements 100 and 150. The following method can be used to reduce the amount of 
overhead used by DELTA. 

>10 WHEN A 



>INACTIVE 10 

>ATS 100; ACTIVE 10;GO 

>ATS 150; INACTIVE 10;GO 



Defines the breakpoint assigned with a 
number of 10. 

Turns it off. 

Silently turns it on at 100. 
Silently turns it off at 150. 



AT is much less costly than having a data breakpoint in effect all the time. After 
the WHEN has served its purpose, KILL it. 



5. The WHEN command is not al lowed for FEP programs. 
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Transfer of Control Commands 

The transfer of control commands include the following: 
GO, BREAK. GOTRAP. 

The commands in this category allow the user to conditionally or unconditionally alter 
the flow of program control. 



GO Command 

Format : 



G[0] 



pos i t i on 
AL[L] 

H[OST] [position] 
fprg-res [position] 



Parameters: 

position will cause execution to resume at the specified position. If not specified, 
position is assumed to be the current value of $IC. 

FEP Parameters: 

ALL causes program execution to resume at the current position for all programs — 
Host and FEP. 

HOST causes program execution to resume either at the current position or at a 
specified position for the Host program. 

fprg-res causes program execution to resume either at the current position or at a 
specified position for the specified FEP program. 

Descript ion: 

This command is used to resume program execution either at the current position or at a 
specified position. 



Example: 

Command 
GO 100 

GO READ.REC 

GO ECUB:100 

AT 100; DISPLAY X; GO 



Explanat ion 

Resume execution at statement number 100 of 
the current ECU. 

Resume execution of the statement labeled 
READ_REC in the current ECU. 

Resume execution at statement number 100 
of ECUS. 

When control reaches statement 100 of the 
current ECU, display X and continue 
execut ion. 



AT 100 IF A > B ;DISPLAY X; When control reaches statement number 100 
GO 200 IF A EQ 40; GO of the current ECU, if A is greater than B, 

then display X and continue execution at 
200 if A is equal to 40 or at 100 if A is 
not equal to 40. 
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Usage Notes: 



1. Users of higher level language processors are warned that some language compilers 
generate optimized code. This means that some statements are combined by the 
compiler, and cannot be executed out of order if the proper results are to be 
obtained. For example: 

19: B = 6 
20: A = B+5+D 
21 : C = B+5+E 



The compiler might compute the value of B+5 in statement 20 and save it in a 
register of temporary storage location. For statement 21, the value of B+5 is 
fetched from the saved cell, and used in the equation. B+5 is not recomputed. This 
saves time and reduces the amount of code produced. However, if a breakpoint is 
placed at 20, and a GO 21 is performed, statement 20 is never executed. The value 
B+5 is never computed and a possibly wrong answer will be produced by statement 21. 

This example is simple, but shows that the GO [position] command should be used with 
care in code produced by optimizing compilers. In general, at least for PL-6, 
FORTRAN and COBOL, it is safe to "GO label" (paragraph name for COBOL). The 
compiler is expecting multiple entry paths to that statement, and will not generate 
code that relies on previous statements. 



BREAK Command 
Format : 
B[REAK] 
Descript ion: 

The BREAK command causes control to be given to the break handler (declared in an M$INT 
monitor service call). A BREAK frame is placed on the user Task Control Block (TCB) 
before giving control to the break handler. 



Usage Notes: 



1. The BREAK command should not be confused with the break key. Depressing the break 
key at any time during a debugging session gives control to DELTA unless the user 
has specified TRAP BREAK. If TRAP BREAK has been specified, DELTA gives control to 
the break handler without reporting the break. To direct a break to DELTA even 
though TRAP BREAK has been specified, the user enters CTRL Y, then DELTA. This will 
simulate a break that DELTA will not pass to the break handler. 



GOTRAP Command 

Format : 



G[0]T[RAP] 



position 

H[OST] [position] 
fprg-res [position] 
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Parameters: 



position will cause execution to resume at the specified position. 
FEP Parameters: 

HOST causes control to be transferee! to the Host program's exceptional conditions 
routine for the condition that caused entry to DELTA. 

fprg-res causes control to be transferred to the specified FEP program's exceptional 
condition routine for the condition that caused entry to DELTA. 

Descr i pt i on : 

This command transfers control to the exceptional condition routine for the condition 
that caused entry to DELTA. (This command is used to enter the TRAP routine and the 
EVENT routine.) 

Usage Notes: 

1. When the command is issued, the information about the exceptional condition is moved 
into place in the TCB. If position is specified, the Instruction Counter (IC) value 
in the TCB is set to reflect that position. Execution resumes at the handler for 
the exceptional condition that caused entry to DELTA. 

2. For FEP programs: 

If position is specified, the Instruction Counter (IC) value in the TSA is set to 
reflect that position. Execution resumes at the specified handler for the 
exceptional condition that caused the specified FEP program's entry to DELTA. 



Procedure Stepping Commands 

The procedure stepping commands include the following: 

STEP, GOSTEP, GOTRAPSTEP. 

The commands in this category allow continued execution one unit at a time. Possible 
unit sizes are INSTRUCTION, SUBSTATEMENT. STATEMENT, and PARAGRAPH. ONE CALL is a 
special case unit. 



STEP Command 

Format : 
S[TEP] [n] 
Parameters: 

n is an octal or decimal constant specifying the number of steps to be taken. If n 
is omitted, one step is taken. The right bracket (]) may be used in place of STEP. The 
STEP command format then becomes ] or n]. 
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Descr i pt ion: 

The STEP command causes execution to proceed for a given number of steps. 
Examp I e : 

Command Explanation 

STEP 5 Take 5 steps (instructions or statements, depending 

on the context in which the command is used). 



STEP BY Command 

Format : 

S[TEP] B[Y] mode 
Parameters: 

mode is one of the following: 
Mode 

INSTRUCTION] 
SU [ BST AT EMENT ] 



STfATEMENT] 
P[ARAGRAPH] 



Explanat ion 

A machine level instruction. 

A substatement as defined by the compiler. 
A substatement is usually defined as a single 
statement in a multiple statement line; that 
is, a single source code line in which more 
than one statement appears. 

A source statement. (The default step mode 
is STATEMENT. ) 

A COBOL PARAGRAPH, or the next source line 
containing a label in non-COBOL ECU s. 



Descr i pt ion: 

The STEP BY command sets a new step mode (unit size), and then steps once, 
Example: 

Exp I anat i on 



Command 
SB I 

SBST 



Step one instruction and set the step mode to 
INSTRUCTION. 

Step to the beginning of the next statement, 
and set the step mode to STATEMENT. 



Usage Notes: 

1. Use SHOW STEP to display the current step mode. 
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STEP ONE CALL Command 



Format : 

S[TEP] 0[NE] C[ALL] 
Descript ion: 

This command temporarily overrides the current step mode without setting a new one. The 
STEP 0[NE] C[ALLJ is used only when the current user program statement is a CALL 
statement. Execution will next stop at the statement immediately following the CALL 
statement, or at the ALTRET statement, if the called routine ALTRETURNs. The current 
mode is unchanged. 



Example: 

Command 
SOC 

Usage Notes: 



Explanat ion 

DELTA will halt execution when the CALLed 
routine RETURNS or ALTRETURNs. 



1. This command is used to continue stepping in the current routine, without stepping 
through a called routine. 



GOSTEP Command 

Format : 



G[0]S[TEP] 



pos i t i on 

H[OST] [position] 
fprg-res [position] 



Parameters : 

position will cause execution to resume at the specified position. 
FEP Parameters: 

HOST will cause execution to resume at the current position or specified position in 
the Host program. 

fprg-res will cause execution to resume at the current position or at the specified 
position in the specified FEP program. 

Descript ion: 

This command performs the GO function but, at the same time, directs that a single step 
(instruction or statement) be performed. 

Usage Notes: 

1. One step will be performed at position. This command is equivalent to: 

LET $IC position 
STEP 



CE39-03 



GOSTEP Command 



4-11 



GOTRAPSTEP Command 

Format : 



G[0]T[RAP]ST[EP] 



pos i t i on 

H[OST] [position] 
fprg-res [position] 



Parameters-: 

position will cause execution to resume at the specified position. 
FEP Parameters: 

HOST will cause execution to resume at the current position or the specified position 
in the Host program. 

fprg-res will cause execution to resume at the current position or the specified 
position in the specified FEP program. 

Descr i pt i on : 

This command performs the same function as the GOTRAP command except that the step level 
of operation is placed into effect. 

Usage Notes: 

1. One step is performed from the beginning of the exceptional cond i t i on hand I er for 
the condition which caused entry to DELTA. If position is specified, the IC value 
in the TCB frame for the exceptional condition is set to reflect that position. 

2. For FEP programs: 

If position is specified, the IC value in the TSA frame for the exceptional 
condition is set to reflect that position. 



Special Purpose Execution Commands 

The special purpose execution commands include the following: 

XCON, EXIT. ALIB, UNSHARE. 

The commands in this category allow interaction with the monitor service calls M$XCON, 
M$SAVE, M$LDTRC, M$LINK, M$ALIB. and M$UNSHARE. (Knowledge of the appropriate areas of 
the Monitor Services Reference Manual (CE33), especially the section on Exception 
Condition Processing, is assumed in the following discussion.) 



XCON Command 

Format : 

XC[ON] 
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Desc r i pt i on : 

This command simulates an exit control condition, that is, a condition which wi I I cause- 
entry to the routine specified in an M$XCON monitor service call. It is most useful in 
avoiding the one condition where having DELTA associated with a run unit will cause- 
different results. 

Assume a run unit ha3 an exit control (M$XCON) , but not a trap control (M$TRAP) routine. 
When the program runs without DELTA, any error or abort condi t ion wi I I cause direct 
entry to the exit control routine. However, when the program runs under the control of 
DELTA, these conditions are caught and held by DELTA, and reported to the user. In this 
case, the GOTRAP command will not work: DELTA checks to ensure that the program has a 
trap routine for the error or abort condition. The XCON command must be used to give 
control to the exit control routine. ' 

The XCON command may also be used to give control to an exit control routine for exit 
conditions such as M$EXIT, M$ERR, M$XXX. and M$SAVE or M$LDTRC. In these cases, GOTRAP 
will work, since DELTA treats the exit control routine specified by M$XCON as a trap 
control routine for exit conditions. The TRAP XCON command will also work for exit 
conditions, for the same reason. 



EXIT Command 

Format : 
EX[IT] 

Desc r i pt i on : 

DELTA checks to ensure that the user does not force an exit condition while the run unit 
is already in exit control, 03 this will cause the program to be run down, and control 
to return to IBEX. This feature makes it difficult for a user to terminate a debug 
sess i on un i ntent i ona I I y . However, there are three condi t ions which require an exit from 
exit control to continue debugging: M$SAVE,M$LDTRC, and exit from an M$LINKed-to 
program. The EXIT command is used to continue an M$SAVE or M$LDTRC after the final exit 
from exit control. In an M$LINKed-to program, EXIT is used within the exit control 
routine, or after the first exit if the program has no exit control routine. 

Usage Notes: 

1. The EXIT command is not allowed for FEP programs. 



ALIB Command 

Format : 

ALI [B] JR[ETURN] \ [. K[EEP] ] 
|A[LTRETURN]{ 

Parameters: 

RETURN causes a RETURN to the M$ALIB call. 
ALTRETURN causes an ALTRETURN to the M$ALIB call. 

KEEP overrides the DLIB option on the M$ALIB call, forcing DLIB=NO and directs DELTA 
to detect f au I ts, etc. 
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Description: 

The ALIB command causes a RETURN, or an ALTRETURN if DELTA is entered from the M$ALIB 

monitor service call. The GO command may also be used, except if DELTA has been placed 
in the ANLZ or RUM mode. 

Usage Notes: 

1. The KEEP option is not legal when M$ALIB is issued from the ASL domain. 

2. If the RETURN=YES option is used, an ALIB RETURN is performed by DELTA after the 
command specified by the CMD option is performed. 

3. If the M$ALIB call does not specify ALTRET, ALIB ALTRETURN is equivalent to ALIB 
RETURN. 

4. The ALIB command is not allowed for FEP programs. 

UNSHARE Command 

Format : 



UNSHARE 



LL] 

ROGRAM] 1 
IBRARYJJ 



Parameters: 

ALL specifies both the program and library. PROGRAM is the default. 
Descript ion: 

The UNSHARE command causes the program and/or library of an autoshared run unit to be 
unshared via the M$UNSHARE monitor service call. 
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Section 5 
Execution Tracing 



The commands in this category cause the flow of control within a run unit to be recorded 
and displayed upon command. A HISTORY mode may be set such that trace information is 
saved for examination at a later time. Tracing may be conducted at several levels: 

o On al I entry points 

o On specific entry points 

o On a specific entry point 

o On al I transfer points 

o On specific locations 

DELTA maintains a circular history buffer in which data pertaining to each incident 
causing a change in the flow of control is stored. 

The commands described in this section are discussed in the following order: 

TRACE 

HISTORY 

PLUGH 

TRACE Command 

Format : 



T[RACE] 



[X] C[ALLS][SJ {prefix] 
t ransf er-type[SJ 
0[N] 
OF[F] 



Parameters: 

X specifies that only external calls are to be traced. 

prefix specifies that only calls to procedures whose name begins with the character 
string defined by prefix are to be traced. 

OFF turns current TRACE mode off. 

ON turns current TRACE mode on. 

S specifies tracing is to be silent, i.e., entries are to be made to the history 
buffer, but are not displayed. They may be displayed later with the HISTORY command. 
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Table 5-1 


TRACE Transfer Types 






Transfer Type 


Descript ion 








TRANSFERS] 


Traces a I I TSX i 


nstructions. 






STATEMENTS] 


Traces branches 


to the first instruction 


of 


a statement . 


P[ARAGRAPHS] 


Traces branches 


to the first instruction 


of 


a COBOL paragraph. 



Descript ion: 

The TRACE command is used to invoke the maintenance of a history buffer by DELTA, The 
contents of the buffer are dependent upon the type or types of trace specified by the 
various options of the commands. 



Examp I e : 

Command 
TRACE X CALLS 
TRACE CALLSS 
TRACE CALLS S 

TRACE TRANSFERS 

AT FMN$OPNF : 1 00 ; TRACE CALLS; GO 
Usage Notes: 



Expl anat ion 

Trace calls to all external procedures. 

Trace all calls, silently. 

Trace all calls to procedures whose names 
beg in with S. 

Trace all TSX (transfer) instructions. 

When control is received at FMN$OPNF: 100, 
activate the TRACE CALL mode and proceed. 



1. SHOW TRACE displays the current TRACE mode, and KILL TRACE is used to remove the 
current TRACE mode. 



HISTORY Command 

Format : 

H[ I STORY] [n [M[0RE]]1 
[C[LEAR] ] 
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Parameters: 



n is a decimal integer which specifies the number of history entries to be displayed. 
If n is not specified, all entries, or remaining entries, will be displayed. 

MORE is a keyword which specifies that the display is to continue from the last entry 
displayed. 

CLEAR removes all entries from the buffer. 
Descr ipt ion: 

When one of the TRACE modes is active, DELTA ma i nta i ns a list of the trace reports' in 
the history buffer. The history buffer can hold 100 entries, and is circular, meaning 
the 101st entry will replace the first entry; the second is replaced by the 102nd entry. 
The buffer is also last-in, first-out, meaning that the latest (most recent) buffer 
entry is the first to be displayed. Thus, HISTORY shows a backwards f I ow of control. 

Examp I e : 

Command Explanation 

HISTORY 3 Display three history buffer entries starting 

with the latest entry. 

H3M Display the next three history buffer entries. 



Example of TRACE and HISTORY: 

>TRACE CALLS 
>G 

A:3<CALLED> B:1 

B:15<CALLED> C:1 

C:120<CALLED> G:1 

BREAK O G:27 (User hits break) 

>H I STORY 2 

C : 1 20<CALLED> G:1 

B:15<CALLED> C:1 

>H I STORY 5 MORE 

A:3<CALLED> B:1 

No more history 

> 



Usage Notes: 



1. The HISTORY command is used in conjunction with the TRACE command. If the command 
is issued before one of the TRACE commands has been entered, the history buffer will 
contain no entries. 

2. The history buffer is cleared (reset to null) whenever a KILL TRACE command is 
issued. 

PLUGH Command 
Format : 

PL[UGH] [location] 
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Parameters: 



Locat ion may be: 

o an octal or decimal literal 

o on address expression (location reference or position reference) 
o a symbol ic name 
Descr ipt ion: 

The PLUGH (Procedure List Used to Get Here) command displays the chain of procedure 
calls which led to the arrival of the Instruction Counter at the current point. The 
chain links are displayed on a last-in, first-out basis. DELTA'S source for the 
procedure list is the user's automatic stack. A line is displayed which identifies the 
CALL statement which caused the entry to each currently active procedure. If location 
is specified, DELTA uses the location as the base of the automatic stock. 

Example: 

Assume 3 ECU's, which call each other in this order: 

Y2 calls ROOM 
ROOM calls WALL 
WALL cal Is BUILDING 

>G0 

IPR FAULT O BUILDING-.15, , .1 (a program bug is hit.) 
>PLUGH 

WALL:93/TSX1 BUILDING: 3 (PLUGH shows how the program 

arrived at BUILDING from Y2.) 

ROOM:70/TSX1 WALL:1 
Y2:31/TSX1 ROOM: 2 

Assume Z ca I I s X 
X cal Is A 

>REPORT 0 
>PLUGH 

X+.262/TSX1 A (+.60) 
Z+.360/TSX1 X(+.32) 

Z/TSX0! X66_ARET+.1036 (X66_MAUT0)(+.4) 
Bottom Frame 

Usage Notes: 

1. The command is useful only in those run units with activation stack frames. 

2. If the REPORT command is issued with the OFFSET option before doing a PLUGH, the 
PLUGH command will display the offset into the user's automatic stack for each 
procedure. If the offsets are not preceded by a "+" , the offsets are actual 
addresses of static parameter blocks. 

3. A system call to an asynchronous entry will be indicated as a Bottom Frame. 
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Section 6 

Memory Display and Modification 



The commands in this category display and change the contents of both memory and program 
visible registers. The specification of an area of memory is subject to the rules 
detailed in Section 2. The specification of a program visible register is made using 
the appropriate DELTA distinguished name as listed in Appendix A. 

The memory display and modification commands are divided into the following categories: 
o Variable oriented commands 
o Word oriented commands 

Variable Oriented Commands 

The variable oriented commands include the following: 
DISPLAY, LET 

The DISPLAY and LET commands are convenient means of displaying and modifying program 
variables. When the debug schema is available to DELTA, the user need not be concerned 
with specifying any of the attributes of the symbolic name referenced by either of these 
commands. Although DISPLAY and LET are intended for use with variable names, no 
restriction exists concerning the use of address expressions. 

DISPLAY Command 

Format : 

D[ISPLAY] item[\f][, item[\f] ... ] 

Parameters : 

item may be: 

o A scalar variable 

o A major structure 

o A qualified subordinate structure 

o A qualified elementary item 

o An array 

o A subscripted element of an array 
o A subscripted range of an array 

o Any general location reference (address expression) 
o Any general position reference 
o A DELTA distinguished name 
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f is one of the format specifiers from Table 3-1 (see the FORMAT command). In 
general, specification of a format for variables is not necessary since each variable is 
described in the debug schema allowing DELTA to display it in the correct form. General 
address expression items are displayed in octal by default, while general position 
references are displayed in instruction format. The default display mode for any item 
may be overridden by use of the desired format specifier. 

Description: 

The DISPLAY command is used to display an area of memory or a program visible register. 

The DISPLAY command displays program variables by name. The user need have no knowledge 
of their location or internal representation. DISPLAY handles simple variables, 
structured variables, arrays and all of the storage classifications used by the 
supported languages. These are static, automatic, parameters (both in automatic stack 
frames and in static storage) and based for PL-6; File Section, Linkage Section and 
Working Storage Section in COBOL; and all FORTRAN variables including subroutine 
parameters. The allowable forms of reference are as varied as the different data types. 
The PL-6 pointer variables in a pointer qualified reference may be part of a structure 
and may be subscripted. Subscripts themselves may be pointer qualified and/or 
subsc r i pted . 



Example: 

Command 

DISPLAY HAROLD 
DISPLAY J0HN(2) 

DISPLAY JEFF (HAROLD) 



DISPLAY PVAR->BASED I TEM 
DISPLAY SPVAR(3)->BASEDITEM 



DISPLAY SPVAR(PVAR->BASEDITEM)-> 
OTHERBAS E ( P VAR->NEWVA L ) ->MYB AS ED VA L 

DISPLAY ALPHA. BETA. GAMMA 



Expl anat ion 

Simple elementary variable. 

Subscripted variable, using 
I i tera I subscr i pt . 

Subscripted variable using 
elementary variable for the 
subscripted value. Note: A 
variable used for a subscript 
must be a signed or unsigned 
integer (PL-6, FORTRAN, COBOL) 
or a packed or unpacked decimal 
number which represents an 
integer value (COBOL). 

Pointer qualified variable. 

Pointer qualified variable using 
subscripted pointer variable. 

General pointer qualified 
subscripted reference. 

Structure qualified item. Note: 
All levels of a structure must 
be specified. 



A subset of an array may be displayed by specifying a range of subscripts for one of its 

dimensions. A range is specified by two subscript values separated by a colon (:). If 

a subscript or subscript range is not specified for an array item, the entire array will 

be displayed. For example: 

DISPLAY VECTOR (FIRST: LAST) 

DISPLAY MATRIX(3: LASTITEM, THISROW) 



DISPLAY VECTOR 
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Usage Notes: 



1. PL-6 based variables declared with implicit pointers may be displayed without 
specifying the implied pointer, or explicit pointer qualification may be given to 
override the default implication. 

2. While a variable to be displayed may have a range of subscripts specified, a 
subscripted pointer used in a pointer qualified reference may not. That is: 

DISPLAY PTR(2)->VAR.X is allowed 

DISPLAY PTR(2:5)->VAR.X is not allowed. 

3. To DISPLAY a variable not described (referenced) in the current program unit 
requires procedure qualification in order to indicate to DELTA where the schema 
describing the item may be found. Procedure qualification is specified by giving 
the external program unit name of the EPU containing the variable followed by a 
colon (:). For example: 

DISPLAY SUBPROGRAM 1 :XVAR 

DISPLAY MAIN:LOOPCOUNT 

In PL— 6, which has internally nested procedures (IPU), a variable which is local to 
an IPU must be qualified by the EPU and all levels of IPU to that containing the 
variable. 

Assume an external PL-6 procedure called EXPROC with internal procedure LOCPROC 
which, in turn, contains the procedure to ALPHA. To display a variable DATES which 

is local to ALPHA when the program counter is not currently within ALPHA, the 

reference is: 

DISPLAY EXPROC: LOCPROC: ALPHA: DATE 

4. Only one procedure qualification specification is allowed for each item to be 
displayed. This means that all pointers and subscript variables in a general 
variable reference must be in the same procedure. For exceptions to this rule see 
the discussion of the ALTERNATE VARIABLES command in Section 3. 

5. The DISPLAY command also allows the display of addressed locations of memory and the 
program— vi sible registers. In pointer qualified references it is allowable to use 
general address expressions for specifying the pointer location together with a 
based variable name for the item to be displayed. The DELTA distinguished names for 
the program visible registers are listed in Appendix A. For example: 

DISPLAY .400 

DISPLAY .41235->G0RG0.PUUDLY 
DISPLAY $LS1->B$JIT.UNAME 
DISPLAY $X1.$Q 

6. General address expressions are further discussed later in this section under Word 
Oriented Commands. 
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LET Command: 

Format : 

L[ET] item constant 
Parameters: 

item may be as described under DISPLAY. 

constant is any meaningful literal in the current syntax (as specified by the 
currently specified SYNTAX option. (See the SYNTAX command in Section 3.) 

Desc r i pt i on : 

The LET command is used to modify the contents of an area of memory or a program visible 
regi ster . 

Some literals are allowed and mean the same regardless of the current syntax. They are: 

o bit string '001010TB up to 72 bits - left justified 

o octal bit string '123*0 up to 24 octal digits - left justified 

o octal value 0'123' up to 12 octal digits - right justified 

o hex value X'AB29' up to 9 hex digits - right justified 

o character string 'ABC up to 63 characters - left justified 

or 'ABC'C or C'ABC 

o a pointer literal of the form: 

octal word offset [-char offset[-bit of f set]] , segid 

where segid is of the form: 

$LSn, $ASn, or $PSn (n is a decimal number) 

For example: 

.123.$LS0 

.21 2-0-4, $LS4 

Numeric literals are treated differently depending on the SYNTAX option which is in 
effect. This allows numbers to be specified in the form which is natural to the 
language being debugged. 

When SYNTAX FORTRAN is in effect, integer and real values may be specified. Integer to 
real, and real to integer conversion is performed as necessary when the format of a 
numeric value conflicts with the variable data type. Real value constants are specified 
the same as for the FORTRAN INPUT statement except that blanks are not allowed. For 
example: 

4.5, .2. 0.13E-8, 2D12, 6 

When SYNTAX COBOL is in effect, integer (COMP-6) and decimal (COMP) values may be 
specified. Truncation or scaling takes place as necessary to match the input value with 
the scaling specified for the variable. The user is not required to distinguish between 
integer and non— integer values. 

When neither SYNTAX COBOL nor SYNTAX FORTRAN is in effect, the period (.) is used to 
denote octal values, right justified in 36 bits. Numbers not preceded by a period are 
assumed to be binary integers. For example: 
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3,4,1269 
.4, .123 
1 .3 
.129 



decimal specification of binary integer 
octal specification of binary integer 
not legal 
not legal 



Variable references for the LET command are exactly the same as for the DISPLAY command. 

A blank is required between item and literal. This blank is interpreted as the equal 
sign (=) . The use of the = sign in place of the blank is allowed if DELTA'S 
end-of-message activation set is turned off with the KILL EOM command. 
Usage Notes: 

1. If the literal is a character string (e.g., 'ANDERSON'), then the variable must be a 
character string, or any item whose length in bits is 0 modulo 9 (an integral number 
of bytes). The character string constant can be up to 63 characters and is stored 
in the variable left-justified with truncation or blank-filled on the right as 
necessary to match the defined size of the variable. 

2. If the literal is a pointer literal, the variable must be a pointer or any item 
whose size is 36 bits. 

3. If the constant is a bit string or octal bit string, it is stored without regard to 
variable type, left-justified with truncation or zero— filled on the right as 
necessary to match the defined size of the item. 

4. If the literal is an octal or decimal value, it is treated as a 36— bit constant and 
can be stored in any 36-bit variable or in any integer variable regardless of size, 
right-justified with truncation or zero-filled on the left as necessary to match the 
size of the variable. 

5. When specifying item with an expression (e.g., simple octal addresses) or any 
variable or SYMDEF name with an offset expression, the location to which the 
expression resolves is treated as a 36-bit variable. 

Cross Reference: 

See the SYNTAX command. 



Word Oriented Commands 

The word oriented commands include the following: 

EVALUATE. MODIFY. DUMP, FIND, STORE. PMD 

These commands search, display, and modify memory. The user refers to memory locations 
as 36-bit words, that is, as a memory cell. The MODIFY command always refers to a 
single cell, while the DUMP, FIND and STORE commands may reference a single cell or a 
contiguous range of cells. EVALUATE is used to evaluate the address of a variable or 
general address expression and to perform miscellaneous arithmetic conversions. 

DELTA allows considerable latitude in the methods by which the desired cell or cells may 
be designated. These are: 

o Any octal or decimal literal. 

o Any valid position or location reference. 

o Any general variable reference. Note, however, that inasmuch as program variables 
are not necessarily word oriented, DELTA evaluates a general variable reference to 
the address of the word containing the start of the referenced variable. This means 
that if THREEBIT is a bit string variable of length 3 bits, starting with bit 10 of 
cell .2000, any reference to THREEBIT with a word oriented command such as MODIFY 
will cause the entire 36-bit contents of cell .2000 to be displayed and/or modified. 
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EVALUATE Command 

Format: 

E[VALUATE] express i on[\f] 

Parameters: 

expression may be: 

o A symbolic name (e.g., EVALUATE SYMBOL). 

o A symbolic name plus offset (EVALUATE SYMBOL+.10). 

o Simple octal or decimal addresses (EVALUATE 1329\0). 

o Simple address expressions with plus (+) , minus(-), shift left («) , and shift right 
(»). (EVALUATE .60630»2+3). 

o Simple pointer-qualified expressions using SYMDEFS or ENTDEFS even when schema usage 
is disabled. (EVALUATE B$J IT$->. 12) . 

o All forms of pointer and descriptor qualified references as discussed in Section 2. 

(EVALUATE $LS2->MYSTRUCT .NEXT->MS.SS. ITEM) . 

o Any expression that can be resolved and expressed within a 36-bit word. This 
i nc I udes : 

Binary values (signed or unsigned). Bit strings up to 36 bits. Character 
strings up to 4, 9-bit bytes. GMAP6 assembler instructions. 

o If a format is specified, it does not change the default format for the MODIFY 
command. f is one of the format specifiers from Table 3-1. 

Descr ipt ion: 

This command is used to: 

o Perform simple arithmetic. 

o Reduce an address expression to its simplest form. 

o Obtain an address expression for use in some word oriented command. 

o Relate memory addresses to symbolic locations and positions within a run unit. 

o Convert between numbering systems. 

Examp I e : 

Command Explanation 

EVALUATE 35+.13\U Do arithmetic with mixed 

= 46 numbering systems. 

EVALUATE .40«18 Perform logical arithmetic. 
= .40000000 

EVALUATE $LS5->MYSTRUCT . NEXT->MS Reduce this expression to 

.3712 its simplest form. 
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EVALUATE .2011\R 

= PR0G3+.5 :12(L00P) 



To what part of my run unit 
does word .2011 (of the IS) 
relate? 



EVALUATE PR0G3 
= .2004 



Display the octal offset of 
PR0G3 within the IS. 



EVALUATE J 
= $LS4->.7 



What expression may I use to 
address the symbol J which is 
not contained within the IS? 



EVALUATE LDQ P3DEF+. 12.X3.PR2 
= .200422236113 



What is the octal representation 
of this symbolic GMAP6 
i nst ruct i on? 



Usage Notes: 

1. There is no operator precedence; operations are performed left to right. 

2. Default format for output of EVALUATE is octal unless changed by the FORMAT EVALUATE 



3. Format specification is ignored if the resultant address is not in the Instruction 
Segment (IS), that is, cannot be expressed as a value. When this occurs, the output 
is always segid->octal offset (e.g., $LS6->. 1236) . 

4. The EOM (activation) character can be used in place of EVALUATE. The format is: 

express i on[\f ]= 
For example: 

35+.13\U=46 (The 46 is supplied by DELTA). 
Cross Reference: 
See the FORMAT command. 

MODIFY Open Form Command 

Format : 

M[ODIFY] location[\f][/] 

Parameters: 

locat ion may be: 

o an octal or decimal literal 

o an address expression (location reference or position reference), 
o a symbol ic name. 

f may be any valid format specifier. 

/ is the activation form of MODIFY and is allowed if KILL EOM has not been specified. 



command . 
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Descr i pt i on : 

When the open form of MODIFY is used, DELTA first displays the address of the cell to be 
modified followed by its current contents and then prompts for the value to which the 
cell is to be modified. The prompt character (>) is preceded by the letter M (M>) which 
indicates that DELTA is in the mod i f y-act i ve mode. This means that: 

o The indicated address is open for modification. 

o DELTA expects either: 

- A new value to be placed in the open cell and the cell to be closed. 

- A new value to be placed in the open cell, the open cell to be closed and 
another cell to be displayed and opened for modification as specified by one of 
the EOM characters or MODIFY sub-commands. See End-of-Message Characters (EOM). 

- The open cell to be closed without modification. 



End-of-Message Characters (EOM) 

Several special EOM characters (in addition to /) apply to the open form of the MODIFY 
command. If the EOM activation character set has been disabled with the KILL EOM 
command, a special set of sub-commands is provided to indicate the same activity. The 
EOM activation characters along with their substitute sub-commands are shown in Table 
6-1 . 



Table 6-1. EOM Characters and Sub-Commands 


Character 


Sub-Command 


Action Indicated 


Li nef eed 


N[EXT] 


Open next memory cell for modify. Cell 
will be opened and displayed as if it has 
been addressed directly with a MODIFY 
command. 


Up Arrow 


P[REV] 


Open previous cell for modify. 

The cell preceding the current cell will 

be opened and displayed as if it has 

been addressed directly with a 

MODIFY command. 


Left Bracket 
Left Brace 


0[PEN] 


Re-open and re-display the 
last cell addressed by a MODIFY 
command. DELTA remembers the address of 
the last cell (if any) referenced in a 
MODIFY command. 


Tab Character 


Asterisk (•) 


Indirect addressing. 

Display and open for modification the 

cell specified by the contents 

of the currently open cell. 

The interpretation of the 

address contained within the 

cell is dependent upon the format of 

the current display. If the 

current display is in pointer 

format, then the "segid" portion 

of the pointer is used to determine 

the appropriate segment, 

and the word offset portion of 

the pointer determines the 
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Table 6—1. EOM Characters and Sub-Commands (cont.) 


Character 


Sub-Command 


Action Indicated 



[V]/ 



None 



None 



None 



•L[\fj 



>R[V] 



None 



*P[\f] 



FEP EOM Characters: 

None *L[\f] 

None *R[V] 

None *P[V] 



None 



*SP[\f] 



offset within the segment. If the 
current display is in relative 
format, then the right half (the 
least significant eighteen bits) 
of the currently open cell is 
assumed to specify an address 
in the instruction segment. If the 
current display is in other 
than pointer format, then the 
left half (the most significant 
eighteen bits) of the 
currently open cell is assumed 
to specify an address in the 
instruction segment. 

Same as * except do not open the cat I for 
modification. Optionally a format 
specifier may be used. 

Treat left 18 bits as an address 
regardless of displayed format. 
Optionally a format specifier 
may be used. 

Same as *L except that the right half (the 
least significant eighteen bits) of the 
currently open cell is assumed to 
specify an address in the instruction 
segment. Optionally a format specifier 
may be used. 



Treat contents 
open ce I I as a 



of the currently 
pointer regardless of the 
format in which it was displayed. Take 
same action as for the tab EOM character 
or the * sub— command. Optionally a 
format specifier may be used. 



Invalid for FEP programs. 

Invalid for FEP programs. 

Treats the contents of the 
currently open cell (2 words) as a 
pointer. Take the same action as 
for the tab EOM character or the 

* subcommand. Optionally a 
format specifier may be used. 

Treats the contents of the 
currently open cell (1 word) as a 
16 bit address. Take the same action 
as for the tab EOM character or the 

* subcommand. Optionally a format 
specifier may be used. 
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Toble 6-1. EOM Characters and Sub-Commands (cont.) 



Character 



Sub-Command 



Act ion Indicated 



Tab Character 



Asterisk (*) 



Indirect Addressing. 
Display and open for modification 
the cell(s) starting at the 
address specified by the contents 
of the currently open cell(s). The 
interpretation of the address 
contained within the cell(s) is 
dependent upon the format of the 
current display. If the current 
display is in instruction format, 
pointer format or relative format, 
the least significant 20 bits of 
the currently open cell (2 words) 
is assumed to specify an address. 
If the current display is in octal, 
unsigned integer, signed integer, 
bit, or hex format, the contents of 
the currently open cell (1 word) 
is assumed to specify an address. 
Other formats will be errored. 



Usage Notes: 

1. When in the mod i f y-act i ve mode, the sub-command NEXT, PREV, OPEN, and any of their 
abbreviations may be classified by program symbols with the same spelling. When in 
doubt about a possible conflict, the user can use the activation character or leave 
the mod i f y-act i ve mode (return key) before issuing any of these sub-commands. 

2. All of the MODIFY sub-commands may be issued as major commands in which case their 
action is based on the last MODIFY command issued. 



4. 



New values for the open cell can be expressed as octal or decimal numbers, simple 
expressions, address expressions, or instructions in mnemonic form. When the new 
value is specified followed by a carriage return, the value is stored in the 
currently open cell, and DELTA leaves the mod i f y-act i ve mode. For example: 

>MODIFY CPA+.265M 

CPA+.265 / LDPO 3..PR2 M>TRA CPA+.324 
>MODIFY $DS1->.101 
$LS4->.101 / .236 M>$L+. 40000 

If, however, the specifications of the new value is followed by one of the 
characters N, <LF>, P, j, t, 0, *, or <TAB>, then the new value is stored in the 
currently open cell and action is taken according to the descriptions in Table 6—1. 

These characters may optionally be preceded by a format specification indicating the 
desired format to be used for the requested display. These characters, with the 
optional format specification, may be entered either following or in lieu of the new 
value for the currently open cell. When specified in lieu of any new value, the 
currently open cell is not modified. For example: 



Command 

>M0DIFY .1023 

.1023 / .501 M>$L+.4000 I 

.1023 / .4501 MXLF> 



Explanation 

Add .4000 to current eel 
and re-display it. 

Display the next eel I . 
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.1024 / .7777777777 '42 M>\S[ 
.1024 / -30 M> 

>MODI FY .2415 

.2415 / .5006001 M> <TAB> 



Re-display in signed binary 
(dec ima I ) . 



Display indirect through 
current ce I I . 



.5 / .0 M>.2415\P/ 

.2415 / . 5-0-0, $LS1 M> <TAB> 
$LS1->.5 / . 120 M> 



Try it again, this time as 
a pointer. 

. . . then go i ndi rect . 



Although the addresses used in the above examples have been simply expressed, the 
MODIFY command will accept any address specification that can be resolved to a 
segment and word offset within that segment. When an address is specified by using 
variable names, all the qualification rules that apply to the DISPLAY or LET command 
also apply to MODIFY. However, unlike DISPLAY or LET, only the word address portion 
of the variable information is used. For example, the MODIFY command will accept a 
PL-6 variable that is defined as an automatic variable in the current auto frame of 
type BIT(1); but when displayed the whole word containing the BIT(1) variable will 
be printed and the address will be printed as a word offset in the segment 
containing the automatic stack for the current process. For example: 

>D I SPLAY BITVAR 
BITVAR = '1 'B 
>MODIFY BITVAR 

$LS4->.106 / .4000012623100 M> 

When specifying addresses in the run unit's procedure (position reference) when 
using the debug schema information (statement numbers, internal entry names, and 
statement levels) it is necessary to precede the address specification with a colon. 
This causes the address to be interpreted exactly as described for the AT and GO 
commands. For example: 

>MOD I FY 258 (treated as decimal word 

.410 / .104213 M> offset in IS) 

>MODIFY :258 (treated as statement 258 

FMN$0PNF+.32 :258 / LDP4 0, ,PR0 M> in the current external 

procedure) 



MODIFY Closed Form Command 

Format : 

M[ODIFY] location[\f] newcontents [(expected old contents)] 
Parameters: 



location and f are the same as in the open form of MODIFY. 

newcontents is an expression that can be evaluated or is a GMAP6 instruction. 

expected old contents must be enclosed in parentheses () and the left parenthesis 
must be preceded by a blank. The value can be any expression that can be evaluated or a 
GMAP6 instruction. 
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Descript ion: 



The closed or patching form can be issued either directly or can be attached to a stored 
command. The difference in this form is that both the address and the new value are 
specified and the modi f y-act i ve mode is not entered. 

Optionally, a display format can be specified and the expected old value of the 
addressed location can be specified. The format specifier is used to change the default 
format for the display of the modified cell. The default format is octal unless the 
location is in the run unit's procedure space or the new value is specified in mnemonic 
instruction form, in which case both the previous contents and the new contents are 
displayed in instruction format. When the specified expected value does not match the 
previous contents, DELTA treats the command as an interactive MODIFY, displaying the 
addressed location and prompting for a new value. 

Example: 



>M MYLOC+.510 TRA CPA+.210 

MYLOC+.510 / TRA CPA+.210 (LDP0 0, ,PR2) 



>M MYLOC+.510 TRA CPA+.210 (LDP0, ,PR3) 
(LDP2 0..PR3) EXPECTED VALUE NOT FOUND 
MYLOC+.510 / LDP0 0, ,PR2 M> 



The previous contents 
are displayed in 
parentheses . 

Bad expected value. 

DELTA prompts for a 
new value. 



>M MYLOC+.510\O TRA CPA+.510 



Use of format 
speci f i er . 



DUMP Command 



Format : 



DU[MP][A][L] location[,word count][\f] 
Parameters: 



ON 

OVER fid 
INTO 



['title'] 



A indicates that ASCII translation is desired. 



L indicates nonsuppresi on of duplicate lines is desired, 
location may be any form of location or position reference. 

word count defines the number of cells (beginning at location) to be dumped. If word 
count is omitted, cells beginning from location to the end of the memory segment are 
dumped. If missing pages are encountered, they are reported and the dump continues at 
the next page. Word count may be an expression. 

f designates octal *0* or hexadecimal 'X' format for the dump, f may also be "C, in 
which case DUMP becomes the equivalent of DUMPA. 

fid may be any valid CP-6 file identification. 

'title* is any character string to be printed at the top of the dump. 
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Descript ion: 

The DUMP command dumps o range of memory. The user may optionally specify that: 
o Each cell be dumped in either octal or hexadecimal format. 

o The dump output be directed to a destination other than the one currently assigned 
for DELTA'S output. 

o A title line be printed at the top of the dump. 

o The width of the dump output be divided in half such that: 

- the left half is printed in the specified format (octal or hexadecimal) 

- the right half contains the interpretation of all printable characters in ASCII, 
o Duplicate lines not be suppressed. 

Usage Notes: 

1. When fid is specified, the run unit must have a reserved DCB slot to be used by 
DELTA for the duration of the DUMP command. Absence of the fid option specifies 
that DELTA will output the dump through the normal output DCB M$DO. ON will cause 
an error if the file referenced by fid already exists, OVER will overwrite an 
existing file, INTO will extend an existing file or create a new one if none exists. 

2. If fid is LPOWSN , the CP-6 system will release the symbiont file to be printed as 
soon as the dump is complete; a PRINT command to IBEX is then not needed. 

3. The form DUMP location\C is equivalent to DUMPA location. With both forms the dump 
is octal with ASCII translation. 

4. To stop a lengthy DUMP printout, depress the break key. 

5. If location is preceded by a ":", then a substatement and offset must be specified 
before specifying a word count. For example: 

DUMP :100,1,.0, word count 
DUMP : 100, , .0, word count 



FIND Command 

Format : 

F[IND][N[OT]] patternl [F[ROM] range] [U[NDER] maskl] 
[S[UB] pattern2] [U[NDER] mask2] 

Parameters: 

NOT specifies a search for cells whose contents are NOT equal to patternl. 

patternl ,pattern2 may be specified in any form that can be resolved by DELTA into a 
36-bit pattern. This includes: 

o Octal or decimal literals. These are converted to their binary equivalents 
(right-justified with zero-fill). 

o Bit string literals. These are left-justified with zero— fill when necessary. 

o Character string literals. These are truncated to four characters, blank-filled on 
the right if necessary. 

o Octal string literal. These are left-justified with zero— fill where necessary. 
Truncation to a 36-bit value is also performed when necessary. 
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o GMAP6 assembler instruction expression. Single word instructions only. 

maskl ,mask2 may be any of the above literal types, but may not be a GMAP6 
instruct ion. 

range is expressed in the form: 
I ocat i on[ .word count] 

where location may be any valid position or location reference. 

word count defines the number of cells to be searched. If omitted, all cells 
from location to the end of the memory segment are searched. 

Descript ion: 

The FIND command searches a specified range of cells for a specified 36-bit pattern, and 
reports the address of every cell within the range in which the pattern was found. The 
user may optionally specify a secondary pattern with which DELTA is to replace every 
occurrence of the pattern being sought. Both the search and the substitution may be 
conducted under mask. If the search is conducted under mask, the contents of each cell 
in the range is logically ANDcd with the search mask in a work cell to select those bits 
which are to be considered in the comparison. The search pattern is also masked in the 
same way. The work cell is then compared with the masked search pattern. When the 
comparison proves equal, then: 

o If substitution is indicated and a substitution mask is not present, DELTA replaces 
the contents of the entire cell with the secondary pattern, and reports the 
locat ion/posi t ion. 

o If substitution is indicated and a substitution mask is present, DELTA selects those 
bits from the secondary pattern which have corresponding bits set in the 
substitution mask, inserts them into the cell, and then reports the 
I ocat i on/posi t i on. 

o If substitution is not specified the position/location is reported along with the 
ce I I ' s contents. 

DELTA then continues the search until the end of the range is reached. 
Usage Notes: 

1. To stop a lengthy FIND press the break key. DELTA will print out the address of the 
next cell to be compared, and stop. There is no way to continue the search without 
issuing another FIND command. 

2. The FIND command is not allowed for FEP programs. 
Special Considerations: 

Two of the syntax components of the FIND command are associated with certain of DELTA'S 
distinguished names. These assume a default value when DELTA is invoked which can be 
changed in two different ways: 

o Implicitly specified as a syntax component in the FIND command, 
o When referenced by its distinguished name in a MODIFY or LET command. 
SYNTAX DISTINGUISHED 

COMPONENT NAME DEFAULT VALUE 

range $FRANGE Entire instruction segment (only 

modifiable syntactically) 

maskl $FMASK .777777777777 (-1) 
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The SUB pattern and mask are not remembered by DELTA and must be specified each time you 
issue the FIND command and desire substitution to take place. For example: 



PATTERN 
FIND .7 
FIND ' ABCD ' 
FIND TRA :HERE 

FIND TSX1 HERB 

FIND NOT 0 



EXPLANATION 

FIND an octal literal (binary 7). 

FIND a character string literal. 

FIND a GMAP6 assembler instruction which is a 
transfer to the statement label HERE in the 
current compile unit. 

FIND a GMAP6 assembler instruction which is a 
transfer and set index to the external entry 
name HERB. 

Find cells which do not contain zero. 



RANGE 



EXPLANATION 



FROM HERE. 50 
FROM 0 

FROM $LS4->0 
FROM $TCB->0,66 
FROM MYPROG : 20 . . 30 
FROM . 50 , . 20 



50 words, beginning with the data cell named HERE. 

Entire Instruction Segment (IS). 

Entire Automatic Stack ($LS4, $DS1). 

Top TCB frame (66 words long). 

30 octal words from statement 20 in MYPROG. 

20 octal words beginning at location .50 in the 
Instruction Segment ($LS0) . 



FIND under default mask and report only: 

FIND -1 FROM TABLE, 100 
FIND under mask and report only: 

FIND TRA 0 FROM MAINLINE, 1000 UNDER .777000 

The command is to find all TRA instructions within the range. 

Mask is: .000000777000 

TRA op code is: xxxxxx710xxx 

The 0 in TRA is necessary even though it does not enter into the comparison. TRA is 
a GMAP6 instruction; TRA alone i3 a symbol name. 

FIND under default mask and substitute: 

FIND TRA :HERE SUB TRA : THERE 

This command causes DELTA to replace all branches to HERE with branches to THERE within 
the default range. 

FIND under mask and substitute under mask: 



FIND *4'0 FROM WORD_TABLE,50 UNDER .700000000000 
SUB '5'0 UNDER .700000000000 
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This command causes DELTA to find each word in the first 50 words of WORD_TABLE which 
contain a 4 in its high-order octal digit and replaces only that digit with a 5. '4*0 
and '5*0 are expressed as octal literals which are left-justified. 



STORE Command 
Format : 

STO[RE] pattern [F[ROM] range] [U[NDER] mask] 
Parameters: 

pattern may be specified in any form that can be resolved into a 36-bit pattern. 
This includes: 

o Octal or decimal literals. These are converted to their binary equivalents 
(right-justified with zero-fill). 

o Bit string literals. These are left-justified with zero-fill when necessary. 

o Character string literals. These may not exceed four characters. They are 

converted by DELTA into their binary equivalents (left-justified with space-fill 
where necessary). 

o Octal string literals. These are left-justified with zero-fill where necessary. 

o Any GMAP6 assembler instruction expression (Single word instructions only). 

range is as described under the FIND command. The default is the entire instruction 
segment . 

mask may be any of the above literals, but may not be a GMAP6 instruction. If mask 
is specified, DELTA selects those bits from the pattern which have corresponding bits 
set in the mask and inserts them into the cell. The default is .7777777777777 (-1). 

Descr ipt ion: 

The STORE command modifies every cell in a specified range of cells. The contents of 
the cell may be completely replaced or replacement may be on a bit-by-bit basis under 
cont ro I of a mask. 

Usage Notes: 

1. The range for STORE is remembered in the same location as the range for FIND 
($FRANGE) . 

2. The STORE command is not allowed for FEP programs. 



PMD Command 
Format : 

PMD opt ion I ist 
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Parameters: 

optionlist is any list of the following keywords: 

AU[TO] Auto segment (DS1) 

CO[MMON] Common segment (DS2) 

DA[TA] Data pages within Instruction Segment 

DC[BS] A I I DCBs 

OS Al I data segments 

DS1 through DS8 Data segments 1 through 8 

D[YNAMIC]D[ATA] Dynamic data pages within Instruction Segment 

IS Entire Instruction Segment 

JI[T] User JIT 

PL[UGH] Causes same action as the PLUGH command. 

PR[OCEDURE] Procedure pages within Instruction Segment 

RO[SEG] Entire Read-only segment 

TC[B] Task control block (TCB stack) 
Descr i pt ion: 



The PMD command causes all or selected portions of a user's entire program image to be 
dumped. Options allow for general selections of what areas to dump. 

Usage Notes: 

1. The PMD command is not allowed for FEP programs. 
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Section 7 

Mode Control Commands 



The commands discussed under this heading are those used to instruct DELTA to change 
from the normal debug mode to one of two other modes: RUM and ANLZ. RUM mode is used 
for applying permanent patches to a run unit file. ANLZ mode is used for examining the 
running monitor or a system dump file and requires special system privileges. 



RUM Command 

Format : 



fid [, 



RU[M] 
Parameters 



| NUTS I 
UTS=va I ue 



{c 


OPY] } 




NPUT] ' 


JT 


'EST] j' 



[B[UFFERS] = n] 



fid 



is the file identification of the run unit file. 



NUTS overrides the requirement for creation UTS (Universal Time Stamps) to match, 
neither NUTS nor UTS=value is specified, NUTS is assumed. If the run unit is in the 
system account :SYS, IN must be specified. 



If 



UTS=value specifies an octal digit string of the form mm/dd/yy hh:mm:ss.ss which must 
match the creation UTS as given to the run unit by the linker. If neither NUTS nor 
UTS=value is specified, NUTS is assumed. If the run unit is in the system account :SYS, 
IN must be specified. 

INPUT specifies to DELTA that the run unit file is to be opened in the input mode; 
therefore, the run unit may only be examined. (If a file is busy or the user does not 
have write permission to it, the file is opened in INPUT mode.) If neither NUTS nor 
UTS=value is specified, NUTS is assumed. If the run unit is in the system account :SYS, 
IN must be specified. 

COPY creates a new copy of the run unit file with the same name. This is handy if 
the file is already open and the user wishes to modify the run unit without affecting 
the user of the current generation of the run unit. 

TEST specifies that patches made are not to be permanently applied to the run unit. 
The run unit will be opened in the input mode. 

BUFFERS=n specifies the number of buffers for DELTA to use. This speeds up I/O. 
Maximum is 10. Default is 5. 
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Description: 

RUM command causes DELTA to access a run unit file instead of memory for accesses made 
by the MODIFY, FIND, STORE, and DUMP commands. In this manner the programmer can 
examine and change (apply permanent patches to) the run unit. Patches made with the 
MODIFY, FIND, and STORE commands are recorded in the run unit file and may be displayed 
at any time with the LIST command. The DISPLAY and LET commands cannot be used in this 
mode . 

While in RUM mode the patch symbols O, CO, #, and ## can be used (if patch space has 
been included in the run unit) and addresses for these symbols will be permanently 
updated in the run unit for future use. Patch space may be defined in a run unit by 
including the file B_PATCH from the :LIBRARY account in the object file list or using 
IPATCH and DPATCH options on the ILINK command when linking the run unit. The special 
symbols $SA and $PRIV may be modified to change the start address and privilege flags 
associated with the run unit. The special pointer symbol $HEAD may be used to address 
any offset within the head record of the run unit. 

Usage Notes: 

1. When EOM mode is in effect the = and /will activate. Substitution of blanks for 
the = and / in the UTS option is acceptable to DELTA. 



ANLZ Command 

Format : 



AN[LZ] 



RUNNING [.schemaf id] 
dumpf id 



Parameters: 



O specifies the running program. 
RUNNING specifies the running monitor. 



dumpf id is the identification of the dumpf He. If this parameter is omitted, the 
running monitor is used. 

schemaf id is the identification of the schema file. If omitted, M:MON. :SYS is 
assumed . 



Description: 



The ANLZ command causes DELTA to access the running monitor or a dump or schema file 
instead of memory. The command selects the dump file that is to be processed and a file 
from which to take the schema. 
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Section 8 

Miscellaneous Commands 



The following commands, which do not fall into any previous classification are described 
in this section: 

UNFID 
XEQ 
LIST 
HELP 

END/QUIT 



UNFID Command 
Format : 

|dcb# | 
UNF[ ID] jdcbnamej 

Parameters: 

dcb# is the number of the DCB as assigned by the linker specified as a decimal or an 
octal value. (Examples: 10 and .12) 

dcbname is a DCB name such as M$SI. 

Description: 

The UNFID command performs the M$UNFID monitor service on the specified DCB and prints 
the results. 

Exampl e: 

>UNF M$UC 

DCB #3 M$UC UC# (OPEN, UPDATE, TERMINAL) 



XEQ Command 

Format : 

X[EQ] instruction 
Parameters: 

instruction must be specified as a GMAP6 instruction mnemonic. X0 through X7 may be 
used in the tag field to denote indexing. All tag mnemonics are recognized, and in 
addition the tag field may be specified as a decimal number (0-7 only) to indicate 
indexing with X0-X7, or the tag field may be given in octal in which case it will be 
used as given. The PR field may be specified mnemonically with PR0 through PR7 or with 
the decimal numbers 0 through 7. 
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Descript ion: 

The XEQ command causes the immediate execution of a single word machine instruction. 
XEQ is not allowed on certain types of instructions such as transfers. 

Usage Notes: 

1. The XEQ command is not allowed for FEP programs. 



LIST Command 
Format : 
LI [ST] 

Descript ion: 

The LIST command will list all changes made to a run unit in RUM mode. The LIST command 
may be issued while DELTA is in either RUM mode or debug mode. 



HELP Command 

Format : 

$H|HELP| [(processor)][ TOPICS ][ keywordl ][ - ][ keyword2] 
Parameters: 



processor specifies a program or processor that has an associated helpfile in the 
form HELP: processor :[. [account ][. password] ] . The default is the processor currently 
under cont rol . 

TOPICS specifies that only a list of available topics (message names) is required. 
The range of topics is determined by keywordl or keyword2. 

keywordl specifies the name of the message to be printed. 

keyword2 if a range is specified (by including a dash "-"). keyword2 is the upper 
limit of the range. If a range is not specified, keyword2 is a submessage, or category 
within a message. 

Description: 

HELP prints information. 

HELP messages have levels. Once the initial level has been printed, typing a question 
mark prints the next level, usually containing greater detail. Typing two question 
marks prints the entire message. 

Any standard HELP file (even those for other processors) can be accessed with the HELP 
command. 



Examp I e : 

HELP (DELTA) RUM 
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Usage Notes: 

1. The standard CP-6 HELP facility is used by DELTA so the user can get help on any 
other CP-6 processor by entering: 

HELP (processor) [TOPICS] [keywordl] [-] [keyword2] 

END/QUIT Commands 

Format : 

EN[D] } [fprg-res] 
Q[UIT]| 

FEP Parameters: 

fprg-res will cause the specified FEP program to be terminated. 
Descript ion: 

The commands EN[D] and Q[UIT] cause the current DELTA session to be terminated, and 
returns the user to his command processor (IBEX). 
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Section 9 

Debugging FEP Programs 



This section di scusses debugging FEP programs wi th DELTA. . Inc I uded are the fol j owing: 

o New commands pertoining just to debugging FEP programs - (DEBUG, USE, WAIT, STOP). 

o Changes in defaults when debugging FEP programs., , * 

o Changes to existing commands - FEP program debugging specific options. 

o Special Distinguished Names for debugging FEP programs. 



Debugging Forms Programs 

When debugging a forms program, two terminals are required. One terminal is logged on 
as a station that runs the FPL program; the other is a timesharing terminal that runs 
DELTA. 

DELTA may be invoked prior to or during Forms Program execution. All debugging sessions 
begin by starting the Forms at a TP station. Then DELTA is invoked from a separate 
timesharing terminal. As soon as DELTA is activated, it takes control of Forms Program 
execut i on. 



Associating DELTA at Program Invocation 

Associating DELTA at program invocation requires entry of special commands at the TP 
station and the timesharing terminal. 

TP Station Debug Command 

Format : 
DEBUG name 

Parameters: , ;■; 

name is the Forms Program name (as entered in the BEGIN command). 
Descript ion: 

The DEBUG command — instead of the, BEGIN command— is entered at the TP station to invoke 
the Forms Program for debugging. As a result of this command, the Forms Program is 
I oaded , but does not beg i n execution. 

At a separate timesharing terminal, the user invokes DELTA and DELTA responds with a 
prompt. The user then enters the DEBUG command to associate DELTA with the station and 
comgroup that invoked the Forms Program for debugging. 
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DEBUG Command 

Format : 

DEB[UG] station I AT i jcomgroupf i d\ 
jONj jTP/tpacct j 

Parameters: 

station is a character string of eight characters or less that defines the station 
name of the terminal running the Forms Program to be debugged. If station is all 
numeric, it must be entered in quote strings. 

comgroupfid is a comgroup fid of the form CG[$psn]/name . acct or of the form CG[#psn] 
name.acct. 'name* identifies the comgroup through which the FPL program is 
communicating. 

tpacct is a character string of eight characters or less that names the account in 
which the particular instance of TP is being run. 

Description: 

This command associates DELTA with the TP station. The user can then enter DELTA 
commands, including GO to start execution of the Forms Program. 

Example: 

At STAT I ON 1 on the instance of TP called PAYROLL, the user enters: 
DEBUG PAY 

At the timesharing terminal the user enters: 
! DELTA 

DELTA C00 HERE - NO RU ASSOCIATED 
>DEBUG STAT I ON 1 AT TP/PAYROLL 

In this example, the Forms Program called PAY is loaded and halts. Then DELTA is 
invoked to debug the Forms Program operating on behalf of STATI0N1 on the PAYROLL 
instance of TP (i.e., PAY). 



Post-associating DELTA 

After a Forms Program has been invoked via the BEGIN command, the user can associate 
DELTA. At a timesharing terminal, the user invokes DELTA and enters the DEBUG command 
as shown above. DELTA assumes control over the execution of the Forms Program, the user 
may then enter DELTA commands. 

Usage Notes: 

1. If a second DEBUG command is entered before the user QUITS or ENDS the first program 
being debugged, DELTA will do a KILL DELTA on the first program and then set up for 
debugging the second specified program. 
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Debugging DCB-Connected FEP Programs 



DCB— connected FEP programs are started via an M$SETFP monitor service call done in a 
program running on the Host. In order to debug DCB-connected FEP programs, the user 
ju3t starts the Host program under DELTA. 

1U 

i HOSTRU . 
or 

I START HOSTRU UNDER DELTA 

This associates DELTA with the Host program and with any FEP programs started via an 
M$SETFP monitor service call by the Host program. DELTA will identify which program the 
user is dealing with by preceding the prompt ('>') with the value the user specified for 
RES on the M$OPEN of the FEP program. 



Exampl e 
!U 

! HOSTRU. 

DELTA C00 HERE IC=TEST:1 [PROC] 
>G 



Explanat ion 



User does GO to host 
program so M$SETFP can 
happen . 



HOST PROGRAM STOPPED IC=TEST:4956 [MONITOR CALL] 
(UC05) IC=A:1 [PROC] 
FPGR STARTED VIA M$SETFP 
UC05> 



User gets control when 
FEP program (UC05) gets 
started - user can enter 
DELTA commands for this 
FEP program, i.e., set 
breakpoints, GO, etc. 



Post Association of DELTA 

To associate DELTA with a Host program and the FEP programs started by the Host program 
via an M$SETFP monitor service call, the user types CTRL Y. IBEX prompts with a double 
bang (!!). The user types DELTA to associate DELTA with the interupted Host program and 
the FEP programs associated with the Host program. Any FEP programs which have been 
started by the Host program will be reported to the user. When DELTA is associated, if 
the host program or any FEP program is autoshared, the user should use the UNSHARE 
command if any modification of procedure (including breakpoints) is to be done. 

Examples Explanation 

IHOSTRU. Program does not prompt as expected; 

a loop is suspected. The user enters 
<CTRLXY>. 

! ! DELTA 

DELTA C00 HERE IC=TEST : 5053 , . .3 [ASSIGNMENT] 

(UC05) IC=A:10 [ASSIGNMENT] 

> 
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Debugging a Specified SYSID on a Specified FEP — 

DELTA may be associated with a FEP program (FPRG) by specifying the sysid and fepname of 
the program on the DEBUG command. 



DEBUG Command 

Format : 

DEB[UG] sysid I AT | fepname 

Parameters": - ' <' ; ' " ' '■■ ' '"'^ '''' 

sysid is the decimal sysid of the desired FEP program to debug. 

fepname is a character string of eight characters or less that identifies the FEP in 
which the program to debug is running. 

Descr i pt ion: 

This command associates DELTA with the FEP program identified by its sysid and the FEP 
in which it is running. The user can then enter DELTA commands, including GO to start 
execution of the FEP program". 

Example: 

At a timesharing terminal the user enters 
! DELTA 

DELTA C00 HERE - NO RU ASSOCIATED : 
>DEBUG 21 AT FEP12 

DELTA is associated with the FEP program in FEP12 that is sysid 21. 

Usage Notes: 

1. If a second DEBUG command is entered before the user QUITs or ENDs the first program 
being debugged, DELTA will do a KILL DELTA on the first program before setting up 
for debugging the second specified program. 

WAIT Command ' 

Format: 

WA[IT] 

Description: 

The WAIT command causes DELTA to wait for the next event from an FEP program-i .e . , 
hitting a breakpoint, trap, etc. This command is especially useful after the user has 
done a GO to one or two FEP programs, does not want the Host program to continue 
execution, and wants to wait for the next breakpoint or trap in one of the executing FEP 
programs . 
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STOP Command 

Format : ' 

STOP |A[LL] \ 

jfprg— resj ..' ,( 

Parameters: ■ - . ■,./> :v,--,- . .,■ 

ALL specifies all FEP programs. 

fprg-res specifies a particular FEP program. This is the value the user specified 
for RES on the M$OPEN of the FEP program. 

Descr i pt i on: 

The STOP command will cause the specified FEP program(s) to be interrupted. DELTA wi I 
report the location at which any FEP programs were interrupted to the user and prompt 
for commands. 



Examp I e : 



>STOP ALL 

(UC05) IC=A:10,,.3 [ASSIGNMENT] 
(UC10) IC=B:310,..4 [CALL] 



> 



User can now enter DELTA commands. 



USE Command 



Format : 



U[SE] jfprg-res 

1h[ost] 



Parameters : 



fprg-res specifies a particular FEP program. This is the value the user specified 
for RES on the M$0PEN of the FEP program. 

HOST specifies the host program. 



Descr i pt ion: 



The USE command is used to specify a particular program the user wants to examine. If 
the specified FEP program is running, it will be stopped for the user to examine it. 




Example: Explanation: 



>USE UC05 This specifies the FEP program 

'" ; '» identified by UC05. 



>USE HOST 



This specifies the host program. 
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Usage Notes: 



1. When a USE command is done by the user, DELTA will remember the state of the program 
being USEd and if another USE command is done without GOing the first program, the 
first program will be returned to its original state. 

Defaults when Debugging FEP Programs 

o A number preceded by a period is a hexadecimal number when debugging FEP programs 
(it is an octal number when debugging Host programs). 

o A maximum of 20 breakpoints are allowed for a single FEP program. 



Existing Command Changes 

Several of the existing DELTA commands have new options which pertain to debugging FEP 
programs. Below is a list of the commands and a summary of the new options. For more 
detail, see the desired command. 



Command 
GO 

QUIT 

KEEP/TRAP/IGNORE 

KILL 
SHOW 



MODIFY 



New Opt ions 

f prg-res 
ALL 
HOST 



GO a specific FEP program 
GO ALL FEP programs 
GO the host program 



f prg-res - QUIT a specific FEP program 

f prg-res - identifies a specific FEP program 
ALL - identifies ALL FEP programs 

HOST - identifies the Host program 

DELTA fprg-res - disassociates DELTA from the 
specified FEP program 

FPRG's - shows state of all FPRGs - if 
stopped, shows current IC 

fprg-res - shows state of a specific FEP 
program 

M[ODIFY] D[OUBLE] [W[ORD] - Modify two 

words - specifically 
tells DELTA you want 
to modify two words. 



Distinguished Names 

DELTA recognizes many distinguished names related to FPRGs as syntactical components of 
DELTA'S commands. These names are listed below. 

Included are the machine registers visible to programming and usage and default formats 
for display. D, L, M, and P indicate DISPLAY. LET, MODIFY, and POINTER usage 
respectively. When one of these is used in a pointer qualified reference, it must be 
the leftmost name in the expression. 



NAME REFERS TO: USAGE 

$B1 to $B7 Corresponding 16-bit Base Register P,D,L,M 

$R1 to $R7 Corresponding 16-bit General D,L,M 
Register 

$M1 to $M7 Corresponding 8-bit Mode Control D,L,M Hex 
Register 



DEFAULT 
FORMAT 

Hex 
Hex 
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$T 
$S 
$ 

$IV 

$z 

$ASV 



$CI 
$IND 

$IC or $P 
$ISR1 to $ISR7 
$AUTO 

$DS1 to $DS4 



Stack address Register (16 bits) 
System Status Register (16 bits) 
Address associated with a trap 
(20 bits) 

Contents of $B3 at the time of a 
trap (16 bits) 

Z— word-mi see 1 1 aneous information 
relative to a trap (16 bits) 
Address Space Vector — the base 
of an MPU image in memory (20 
bits) 

CIP Indicator Register (8 bits) 
Indicator Register (8 bits) 
Instruction Counter (20 bits) 
Instruction Segment 
Auto Segment 

Corresponding LCP6 Data Segment 
descr iptor 



D.L.M Hex 

D.L.M Hex 

D.L.M Hex 

D.L.M Hex 



D.L.M 

D.L.M 

D.L.M 

P.D 

P.D 

P.D 



Hex 
Hex 



Hex 
Hex 

Re I at ive 
Descr i ptor 
Pointer 
Descr i ptor 



System Areas 

This group of distinguished names are used exclusively as pointers to various system 
areas . 

NAME REFERS TO: 

$ROSEG Read-Only-Segment 

$RDBR Remote descriptor array 

$TSA Trap Save Area 

$DCBn Refers to DCB #n 
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Appendix A 
Distinguished Names 



DELTA recognizes many distinguished names as syntactical components of DELTA'S commands. 
These names are listed below. 

Included are the machine registers visible to programming, and usage and default formats 
for display. D. L, and M indicate DISPLAY, LET, and MODIFY, respectively. 



NAME 


REFERS TO: 


USAGE 


DEFAULT 
FORMAT 


$A 


Bits 0 to 35 of Accumulator (AQ) 


D.L.M 


Octal 


$AU 


Bits 0 to 17 of Accumulator 


D,L,M 


Octal 


$AL 


Bits 18 to 35 of Accumulator 


D,L,M 


Octal 


$Q 


Bits 36 to 71 of Accumulator 


D,L,M 


Octal 


$QU 


Bits 36 to 53 of Accumulator 


D.L.M 


Octal 


$QL 


Bits 54 to 71 of Accumulator 


D.L.M 


Octal 


$E 


Exponent Register (8 bits) 


D.L.M 


Octal 


SEA 


Exponent and A Registers 


D 


Floating Point 
Single Precision 


$EAQ 


Exponent, A, and Q Registers 


D 


Fl oat i ng Poi nt 
Double Precision 


$IND 


Indicator Register (18 bits) 


D,L,M 


Octal 


$X0 to 
$X7 


Corresponding 18-bit Index 
Reg i sters 


D.L.M 


Re I at i ve 


$IC 


Instruction Counter (18 Bits) 


D, L,M 


Re I at i ve 



Program Visible Descriptors 

These distinguished names are used to refer to descriptors either in machine registers 
or in defined positions in segments. P, D, and M indicate POINTER, DISPLAY, and MODIFY 
usage, respectively. When one of these names is used in a pointer qualified reference, 
it must be the leftmost name in the expression. 



NAME REFERS TO: USAGE 

$SSR Safe Store Register (When used as P,D 

a pointer $SSR points to the 
user's safe store frame as 
placed on DELTA'S TCB. 

$ISR Instruction Segment Register P.D 

$ASR Argument Segment Register D 



DEFAULT 
FORMAT 

Descr i ptor 



Descriptor 
Descr i ptor 



CE39-03 Program Visible Descriptors A-1 



$LSR Linkage Segment Register D 

$PSR Parameter Segment Register D 

$LS0 to Descriptor n in Linkage P,D 
$LSn Segment 

$AS0 to Descriptor n in Argument P,D 
$ASn Segment 

$PS0 to Descriptor n in Parameter P,D 
$PSn Segment 

$DS1 to Corresponding CP-6 Data Segment P.D 
$DS8 Descriptor (DS1 = LS4, etc.) 

$DR0 to Corresponding Operand P,D 
$DR7 Descriptor Register 

$PR0 to Corresponding Pointer P.D.M 
$PR7 Registers (DRn , SEGIDn, ARn) 

$AR0 to Corresponding Address D,M 
$AR7 Registers 



Descriptor 
Descriptor 
Descriptor 

Descr i ptor 

Descr i ptor 

Descr i ptor 

Descriptor 

Descriptor 

Addr Register (AR) 



XDELTA and ANLZ Only 

With the exception of $SSR, the distinguished names in this group are addressable only 
by XDELTA and the ANLZ mode of DELTA. 



NAME 

$WSR0 to 
$WSR7 



$WSQ0 to 
$WSQn 

$SSR 



$REAL 
$VIRT 
$RVB 

$USD 

$HJIT 

$CGn 



USAGE 

Refers to the corresponding Working Space Register. May be 
used in DISPLAY, MODIFY, and LET commands. The default 
display format is in decimal. 

Refers to word n of the Working Space Page Table Directory 
(WSPTD). May be used in the DISPLAY command. 

Refers to the Safe Store Register for the current domain 
(see USE command). May be used as a pointer or may be 
displayed (descriptor). 

May only be used as a pointer to address real memory. 

May only be used as a pointer to address virtual memory. 

Refers to the Recovery Buffer. May only be used as a 
pointer (ANLZ file mode only). 



Refers to the User Directory, 
only be used as a pointer. 



(ANLZ file mode only). May 



Refers to the Housekeeping Job Information Table for the 
current domain. May only be used as a pointer. 

Refers to nth Communications Group area of system dump file. 
May only be used as a pointer. (ANLZ file mode only). 
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RUM Mode Only 

The distinguished names in this group are addressable by the RUM mode of DELTA. 
NAME USAGE 

$SA Refers to start address in head record. 
$PRIV Refers to privilege bits in head record. 

$HEAD May be used as a pointer to any offset in the head record. 

System Areas 

This group of distinguished names are used exclusively as pointers to various system 
areas. 

NAME REFERS TO: 

$TCB Top Frame of the Task Control Block 

$JIT Job Information Table 

$PARMn Parameter §n of PL-6 External Procedure ($PR2->n+2) 

$DCBn Refers to DCB #n 

Command Work Areas 

This group of distinguished names refers to various work areas used by certain commands. 



NAME USAGE 

$1 Refers to the position indicated by the current Instruction 

Counter. $1 may be used in a MODIFY Expression (e.g., 
MODIFY $1+3). 

$0 Refers to the last word of memory that was modified. 

Only the MODIFY command (along with N, P, and *) 
changes the value of $0. 

$L Refers to the last value displayed by DELTA as a result of 

a MODIFY type command. 

$FRANGE Refers to the range specification of the FIND/STORE 

displayed. It may only be displayed. 

$FMASK Refers to the Find Mask (maskl) in the FIND command. 
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Patching Symbols 

This group of distinguished names refers to various work areas which are managed by 
DELTA when the RUM Mode is invoked. 



NAME USAGE 

O Refers to the next word in the procedure patch space. 

00 Refers to the next even word in the procedure patch 

space. 

§ Refers to the next word in the data patch space. 

## Refers to the next even word in the data patch space. 

$RI Replaced Instruction. Refers to the contents of the last 

modified memory word not contained within either the data 
or procedure patch space. 

$NA Next Address. Refers to the address of the word of 

memory immediately following $RI . 

$REMO Used to DISPLAY the remaining amount of Procedure patch 

space. 

$REM| Used to DISPLAY the remaining amount of Data patch 

space . 



These symbols may also be used in the debug mode to make temporary patches to the run 
unit image in memory. 
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Appendix B 

Assembler Instruction Formats for Patching 



This set of Assembler Instruction Formats is used for patching in RUM or DEBUG modes. 

DELTA handles the standard GMAP6 instruction format for 1-word instructions except for 
the f o I I owi ng : 

o The ZERO op code has the following format: 

ZERO any DELTA position or location reference, octal constant. 

The ZERO op code specifies the contents of a word of memory. The evaluated position 
or location reference is placed in the left half of the word and the octal constant 
is placed in the right half. If the position or location reference is preceded by a 

a substatement and offset must be specified before specifying the octal 
constant. For example: 

ZERO : 100,1 , .1 , .1000 
ZERO :100, , , .1000 

o The PTR op code has the following format: 

PTR any DELTA position or location reference, octal constant. 

The PTR op code specifies the contents of a word of memory in pointer format. The 
only segids which may be specified are .6000— .60FF. The octal constant specifies 
00-FF of the segid. The evaluated position or location reference is placed in the 
left half of the word. It is not possible to specify a character or bit offset. 

o A "!" after the op code causes DELTA to set the inhibit bit in the generated 
instruction word. For example: 

LDA1 .4010.DL 

Multiword instructions must be specified to DELTA in octal. No mnemonic form is 
available for the instruction word or the descriptors. When DELTA prints a multiword 
instruction, the octal value of the instruction word is preceded by the op code 
mnemon i c . 

The following multiword instruction: 

MLR FILL=' 040*0 
ADSC9 2.QL.PR1 
ADSC9 TEXT 

must be entered to DELTA as: 

.40000100506 

.100002000010 

.1000010 

and will be printed out by DELTA as: 

MLR .40000100506 
.10000200010 
.1000010 
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Note: The descriptor words may be printed in octal or some single instruction format. 
The user must specify \0 format to force printing of the descriptor in octal. 

For code that is the subject of XEC or XED, or that is generated dynamically, it is 
advantageous to keep DELTA away from it, i.e., do not use AT, STEP, XEQ. TRACE TRANSFER 
in such code, unless the user knows how DELTA will modify the code to do these commands. 
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ACTIVE/ INACTIVE command - 1-8 3-17 
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Array - 2-2 
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ATS keyword - 3-14 
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BIT specifier - 3-10 
BREAK command - 1-11 4-8 
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CE39-03 



Index 



D 



data addresses - 2-1 

Data Breakpoint Command - 4-5 
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Debugging a Specified SYSID on a Specified FEP - 9-4 
Debugging DCB-Connected FEP Programs - 9-3 
Debugging Forms Programs - 9-1 
Debugging mode - 1-2 1-2 
DEBUG Command - 9-2 9-4 
Debug mode - B-1 
debug schema — 1—1 
def aul ts - 3-1 

Defaults when Debugging FEP Programs - 9-6 

DEFINE command - 1-9 2-1 3-11 

DEF keyword - 3-15 3-15 

DELTA invoking - 1-15 

DELTA keyword - 3-15 
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DO command - 1-9 3-19 
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External Debugging - 1-1 
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FORMAT command - 1-9 3-10 
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